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Appendix A for further information on these states. 

unit . art . debug (where unit = fbi, sc, dc, or f0-f5) 

This state enables a summary of debug information to be displayed for the FBI, SRAM, SDRAM, 
and Microengines. Depositing a value of 0 (disabled) through 4 (most information) to this model 
state sets the level of information that is displayed, as shown in the following tables: 

Table 6-3. State Setting Descriptions for fx.art.debug 


fx.art.debug State Setting 

Description 

0 

Disabled. 

1 

View execution pipeline stage 3 (ALU output). 

2 

View all 5 execution pipeline stages. 

3 

View all 5 execution pipeline stages and thread state 
information. 
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Table 6-4. State Setting Descriptions for *.art.debug 


sc.art.debug 

dc.art.debug 

fbi.art.debug State Setting 

Description 

0 

Disabled. 

1 

Enabled. 


f x . art . debugpx 

(where fx = fO through f5, and debug_px = debug_pO through debug_p4) 

When fx.art.debug is enabled to display execution pipeline stage information, the fx.art.debug_px 
state disables the display of the specified Microengine execution pipeline stage information. For 
example, when fO.art.debug is set to 4, the Microengine execution pipeline stage information for 
each stage will be displayed. If f0.art.debug_p3 is set to 0 then only stages 0,1,2, and 4 will be 
displayed. Depositing a value of 0 disables the display. 

The work performed during each pipeline stage is summarized below: 

Table 6-5. Pipeline Stage Work 


Stage 

Work Performed 

0 

Read the instruction from the control store. 

1 

Decode the instruction. 

2 

Look up the operands. 

3 

Perform the ALU/shifter operations. 

4 

Write result to the destination register. 


Depositing a value of 0 (disabled) or 1 (enabled) to this state determines whether the information 
for the execution pipeline stage is displayed. The format of the information displayed is shown in 
the sections that follow. 

6.6.2 Common Execution Pipeline Stage Format 

Each execution pipeline displays the same information on the first three lines. 

====P4 fbox stage (write result) for fO. in ctx: 0 at fbox cycle 63==== 
uword addr = 12 

alu_shf_ri [loop_no, loop_no, 1, 0] ; decrement link_no 

Where: 

Line 1 shows the Microengine execution pipeline stage number (P0 through P4), a description of 
the pipeline execution stage (write result), the Microengine executing this instruction (fO through 
f5), the thread/context number executing this instruction (ctx: 0), and the Microengine execution 
cycle (fbox cycle 63). 

Line 2 shows the location of this instruction in the control store (uword addr = 12). If the 
instruction is aborted due to a branch or other condition, ***ABORTED_UWORD*** will appear 
on this line. If the Microengine is stalled because the Microengine has more than two external 
references waiting to be issued to the appropriate function unit ***STALLED UWORD *** will 
appear. 

Line 3 shows the instruction in this execution pipeline stage including comments. 
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The formats described in the sections that follow are displayed for each execution pipeline stage. 

6.6.2.1 Execution Pipeline Stage 4 - Write the Result 

This is the complete display for execution pipeline stage 4. 

====P4 fbox stage (write result) for fO. in ctx: 0 at fbox cycle 63==== 
uword addr = 12 

alu_shf_ri [loop_no, loop_no, 1, 0] ; decrement link_no 

W_BUS: 00000002 

operand write: GPR_A [0] =00000002 

Where: 

Lines 1 through 3: Common execution pipeline stage information. 

Line 4 shows the output of the ALU (W_BUS = 00000002). 

Line 5 is displayed if the output of the ALU has a destination. It displays where the result is being 
written (GPR_A[0]) and the value (00000002). The value should be the same as W-BUS in line 4. 

6. 6.2. 2 Execution Pipeline Stage 3 - Perform ALU Shift, Decode Instruction 

This is the complete display for execution pipeline stage 3. 

====P3 fbox stage (ALU/shif ter ) for fO. in ctx: 0 at fbox cycle 63==== 
uword addr = 13 

br ! =0_ [loop_rl#] , defer[2] 

A operand: 00000000; pre-shift B operand: 00000007; B operand: 00000007 
shifter op : right shift 0; ALU op : ALU_OP_A_AND_B ; ALU result : 00000000 ; 
old_ccs : ! =0 : >=0 : carry 

Where: 

Lines 1 through 3: Common execution pipeline stage information. 

Line 4 shows the A, B and preshift B operand values. If no shift operation is performed the B and 
preshift B operand values will be the same. 

Lines 5 and 6 shows the ALU and shifter operation that were performed, the result of this operation 
and the condition code status after the operation. If the condition code changes old_ccs will be 
displayed, otherwise new_ccs is displayed. The possible condition code values are: 

Table 6-6. Condition Code Meanings 


Condition Code 

Meaning 

!=0 

Not equal to zero. 

=0 

Equal to zero. 

>=0 

Greater than or equal to zero. 

<0 

Less than zero. 

carry 

Carry. 

no_carry 

No carry. 
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Execution Pipeline Stage 2 - Look Up Operands 

This is the complete display for execution pipeline stage 2. 

====P2 fbox stage (operand lookup) for fO. in ctx: 0 at fbox cycle 63== 
uword addr = 14 
new_head# : 
nop 

A operand: 00000000 (selected from xreg data) ; 

B operand: 00000000 (selected from immed data) ; 

Where: 

Lines 1 through 4: Common execution pipeline stage information. 

Lines 5 and 6 show the operand values that were fetched per instruction. 

Execution Pipeline Stage 1 - Decode Instruction 

This is the complete display for execution pipeline stage 1 . 

===P1 fbox stage (initial decode) for fO. in ctx: 0 at fbox cycle 63=== 
uword addr = 15 

ld_f ield_a [headptr , 1111, $ptr, 0] 

Where: 

Lines 1 through 3: Common execution pipeline stage information 

Execution Pipeline Stage 0 - Read Instruction 

====P0 fbox stage (ustore lookup) for fO. in ctx: 0 at fbox cycle 63=== 
ustore addr = 10 ==> A018108A 
loop_rl# : 

sram[pop, $ptr, temp, templ, 0], ctx_swap 

Where: 

Lines 1 through 3: Common execution pipeline stage information. 

Memory Tagging 

The Transactor provides the ability to tag SRAM or SDRAM memory with information about 
which location was written, what type of reference wrote it, which resource generated the 
reference, and at what Microengine program counter value. Memory tagging is enabled when 
memory is initialized using the mem_init command. 


Watch 

The watch function is a powerful tool that executes code upon the transition of one or more user 
defined states. One purpose of the watch function is to observe states and display information on 
transitions that occur upon the occurrence of some combination of conditions. It is also used to halt 
simulation or deposit data into states when some combination of conditions occurs. The watch 
function is invoked by using the watch command (see the watch command description). 

The watch function can be defined in a command script file and run using 
@ command_script_filename. 
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6.6.5 Breakpoints 

Breakpoints are supported by the Transactor using the ubreak command. A breakpoint causes the 
simulator to stop unconditionally when a thread that is enabled to respond to that breakpoint 
reaches the specified Microengine program counter address. Breakpoints can be set or cleared on a 
thread-by-thread basis. Any number of breakpoints can be set or cleared by specifying one of the 
six Microengine control store states followed by a microcode address in the form of either number# 
or label#, followed by an equal sign (=), followed by a thread mask value. The thread mask value is 
a four bit value where the LSB specifies thread 0 and the MSB specifies thread 3. 

6.6.6 Save and Restore 

The save and restore commands are used to save and restore the state of a model and are used 
frequently in connection with debugging. See the save and restore command descriptions for more 
information. 

6.6.7 Logging A Simulation Session 

A log file can be created that contains information displayed during a simulation session. Log files 
are opened using the log Transactor command and are closed using the close Transactor command. 
See these command descriptions for more information. 


6.7 Transactor Command Script Files 

The Transactor can run command scripts that contain Transactor commands and C commands 
supported by the Transactor’s C interpreter. The following rules apply to Transactor command 
scripts. 

• C commands that require more than one line must terminate each line with a continuation 
character to instructs the interpreter to wait for more input before interpreting the text. 
Continuation characters are of two types: 

— A backslash (\) at the end of a line instructs the interpreter to wait for the subsequent line 
to be input. 

— An implicit continuation, always exists as long as one or more left brackets ({) are not 
terminated with corresponding right brackets (}). 

• Comments can be defined two ways. 

— ANSI C - starting after a slash-asterisk (/*) and ending before an asterisk-slash (*/). 

— C++ - comment starts after a double slash (//) and runs to the end of the current line. 
There are two ways to execute a command script file: 

1 . A command script file can be executed at the command line interface using the 
@ script_filename Transactor command. 

2. A single command script file can run automatically when the Transactor is executed using the 
-i switch (e.g., safe_exact -i script_filename). 
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The safe_exact -i script_filename format can be used to create automated test script. An automated 
test script would contain a series of command using this format. The last command in each 
script_filename would contain the Transactor exit command so that the Transactor exits after the 
command script completes. 

Command scripts can be aborted by placing the return command into a command script. 

Example Command Script File 


The following is an example Transactor command script file. 


// This is an init file 

//********************************************************************* 
// This is the model setup and initialization section. The model 
// initialization includes : 

// 1. One IXP1200 with a NULL chipname- chip 
// 2. 1MB of SRAM memory- mem_init sram lm 
// 3 . 1MB of SDRAM memory- mem_init sdram lm 
// 4. Initialize the entire system - init 
// 

// Note that the chip and memory are initialized before the model . The 
// If statement is not required to initialize the model . Its purpose 
// is to allow this file to be reloaded multiple times during a 
// session. If this statement were not included the Transactor would 

// report an error indicating that the chip and the memory can not be 

// instantiated after the model is initialized. The If statement uses 

// the uninitialized function to determine whether the model has been 
// initialized. The sim_reset command is used to reset the model . 
//********************************************************************* 
{ 

if ( uninitialized ( ) ) 


{ 

// instantiate a chip 
cmd ( "chip" ) ; 

// instantiate some memory 
cmd ( "mem_init sdram lm" ) ; 
cmd ( "mem_init/tag sram lm" ); 

// Initialize the chip 
cmd ( " init " ) ; 

} 

else cmd ( "sim_reset" ); // reset all post-init simulation state 

} 


//*’ 

k * * 

// Thi 

//*’ 

k * * 

dep 

dc 

dep 

sc 

dep 

f 0 

dep 

f 0 

dep 

f 0 

dep 

f 0 

dep 

f 0 

dep 

f 0 

//*’ 

k * * 

// Thi 

//*’ 

k * * 

dep 

fl 

dep 

f 2 

dep 

f 3 

dep 

f 4 

dep 

f 5 

//*’ 

k * * 

// Thi 

//*’ 

k * * 


***************************************************************** 

s section sets up the debug reporting states. 
***************************************************************** 


. art . debug = 0 
. art . debug = 0 
. art . debug = 2 
. art . debug_pO = 1 
. art . debug_pl = 1 
. art . debug_p2 = 1 
. art . debug_p3 = 1 
. art . debug_p4 = 1 


//do not view SDRAM debug info 
//do not view SRAM debug info 
//view FO debug info 
//view all 5 pipeline stages 


********************************************* 


s section turns off unused Microengines 
***************************************************************** 


. art . enable 
. art . enable 
. art . enable 
. art . enable 
. art . enable 


0 // 
0 // 0 
0 // 1 
0 
0 


******************** 


only Microengine 0 will run 
= off 
= on 


********************************************* 


s section turns off unused Microengines 
***************************************************************** 
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dep art . f box_mask = 1 // Turn on fO (binary representation) 

// This is a six bit mask where 
// lsb = uengine 0, msb = uengine 5 

//********************************************************************* 
// This section turn on the Microengines threads 
//********************************************************************* 
dep art.ctx_mask = Oxf // Turn on all threads 

// This is a four bit mask where 
// lsb = thread 0, msb = thread 3 

//********************************************************************* 
// This section is only temporary. This will not be required when the 
// circuit is implemented. 

// 0, msb = uengine 5 0, msb = uengine 5 0, msb = uengine 5 0, 

// msb = uengine 5 

// This section sets abort operands in the last 4 stages of the 
// execution pipe in order to avoid processing garbage uwords (these 
// will be latched in the last 4 stages at the start of the clock edge . 
//********************************************************************* 


dep f 0 . ctl . p0_abort = 1 
dep f 0 . ctl .pl_abort = 1 
dep f 0 . ctl . p2_abort = 1 
dep f 0 . ctl .p3_abort = 1 


//********************************************************************* 
// This section loads the microcode into the program store 
//********************************************************************* 
load_uc f 0 . ctl . ustore llist.list * 

//********************************************************************* 
// This section is specific to the microcode program. It shows how a 
// linked lists can be placed into SRAM memory. 

// The steps are as follows: 

// 1. Create a structure for the elements in the list. 

// 2. Define a pointer to the structure 

// 3. Create the list in memory 

// 4. Write the head of the list pointer to the push pop register 

// 5. Initialize memory with data 

//********************************************************************* 
// Note that the following 5 lines demonstrate the two forms of 
// continuation characters . The "\" character after the first line 
// indicates that the following line is a continuation of the first 
// line. Everything within brackets "{}" are also interpeted as a 
// continuation . 
struct llist \ 

{ struct llist *pnext;// Step 1 
int val ; 

}; 

struct llist:sram *pllist;// Step 2 

pllist = alloc_list( sram, llist, 3 );// Step 3 

// The alloc_list function is used to create three elements 

// of type llist in sram. The return value is the pointer 

// to the first element in the list. Note that the first 

// longword in each element is a pointer to the next element 

// in the list. The last list has a NUL pointer 

dep/s sc .push_pop_regs [0] = pllist// Step 4 

// Write the pointer to the first element in the list to the SRAM 
// unit's push-pop register 

// initialize the values in the array/ / Step 5 

int i ; // initialize memory with data 

for ( i = 1 ; i< = 3 ; i + + ) {// This example simply writes 

pllist ->val = ( i * 1 0 ) ; / / 10, 20, and 30 into the list 
pllist++ ; 

}; 

//********************************************************************* 
// This section deposits the head of the linked list into a 
// Microengine GPR for each thread. 

//********************************************************************* 
dep f 0 . reg . headptr_0=pllist 
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dep f 0 . reg . headptr_l=pllist 
dep f 0 . reg . headptr_2=pllist 
dep f 0 . reg . headptr_3=pllist 

//********************************************************************* 
// This section 

//********************************************************************* 
dep/multi f * . ctl . thread_trigger_mask* = 1 // turn on all threads 
dep/multi f * . ctl . thread_trigger_mask*0 = 0// turn off 0 thread (which 
// is on by default) 


6.8 Enabling the StrongARM Core 

This section describes how to enable and disable the StrongARM Core model in the Transactor. 
You may want to disable the StrongARM core for the following reasons: 

• You are not executing ARM code and want to improve Transactor performance by disabling 
the StrongARM Core. 

• You prefer to use the AMBA Transactor rather than the StrongARM Core model. 

The IXP1200 Developers Workbench automatically performs the necessary steps required to 
enable or disable the StrongARM Core, but users that choose to use the command line interface 
must manually perform the steps that follow. To make this easier, it is recommended that you create 
separate script files to enable and disable the StrongARM Core. Then you can simply execute the 
script files. 

The following states are associated with enabling and accessing the StrongARM Core: 

art.pci_enable Enable PCI registers (and eventually the PCI bus) 

art.kbox_enable Enable StrongARM Core 

art.amba_xact_enable Enable AMBA Transactor 

art.resets_connected_to_reset_csr Connect resets to SA1200_RESET register 

To disable the StrongARM Core model in the Transactor set the states as follows (these are the 
default settings): 

art.pci_enable 0 

art.kbox_enable 0 

art.amba_xact_enable 1 

art.resets_connected_to_reset_csr 0 

To run the Transactor with the StrongARM Core functioning, set the states as follows: 
art.pci_enable 1 

art.kbox_enable 1 

art.amba_xact_enable 0 

art.resets_connected_to_reset_csr 1 

Do not set both the art.kbox_enable and art.amba_xact_enable states at the same time. Results 
will be unpredictable. 

The state art.resets_connected_to_reset_csr when set to 1 connects the SA1200_RESET register 
in the PCI unit to the reset lines of the other functional units. Refer to the IXP1200 Network 
Processor Programmer’s Reference for more information on the SA1200_RESET register. This 
state must be set for the SA1200_RESET register to work properly, but it is off by default for 
compatibility with .ind files written for previous versions of the Transactor. Set this state to 1 when 
writing new .ind files. 
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The SA1200_RESET register is known in the Transactor as p.sal200_reset_reg. 

Example 

To enable the StrongARM Core, the .ind file (after the initialization part) might start with the 
following: 

> art .pci_enable = 1; 

> art . kbox_enable = 1; 

> art . amba_xact_enable = 0; 

> art . resets_connected_to_reset_csr = 1; 

> p . sal200_reset_reg = OxFFFFFFFF ; //Resets the whole IXP1200 chip . 

> go 8 

> p . sal200_reset_reg = OxlFFEFFFF ; //Brings SRAM, StrongARM Core, and FBus out 

//of reset. 

> watch (ucode_watcher , c.r[6]) ucode_f unc ( ) ; //Look at register 6 to determine 

/ /when to load microcode. 

> void ucode_func() { 

> // load ucode here 

> } 

> load_bin_f ile flash[0] your_ARM_binary_code_f ilename_goes_here 

The StrongARM assembly source code might be structured as follows: 


;; initialize processor, bring SDRAM out of reset, etc. 

; ; prepare Microengines to receive microcode (they are already in 
; ; reset) - clear context_enables 

; ; load ucode 
MOV R6 , #1 

;; This doesn't really load the microcode in real hardware, but here 
; ; it f ires off the watcher to load the microcode directly (and more quickly) 

; ; Initialize and bring Microengines out of reset 

; ; Take Microengines out of reset 
; ; Set Microengine CTX_ENABLES register 
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Simulation Switches 

Several pre-defined simulation states exist that act as simulation switches/parameters for the user 
to set. All such states exist under the "sim." hierarchy. 

The following is a description of the states: 


Switch 

Section 

sim.error_count 

6.9.1 

sim.error_handle_mode 

6.9.2 

sim.core_clk_cycle 

6.9.3 

sim.core_clk_freq 

6.9.4 

sim.core_clk_period 

6.9.5 

sim.fbus_clk_cycle 

6.9.6 

sim.fbus_clk_freq 

6.9.7 

sim.fbus_clk_period 

6.9.8 

sim.goto_and_ubreak_key_on_p1 

6.9.9 

sim.halt 

6.9.10 

sim.pci_clk_cycle 

6.9.11 

sim.pci_clk_freq 

6.9.12 

sim.pci_clk_period 

6.9.13 

sim.post_sim_exec_order 

6.9.14 

sim.prune_prefix_comments 

6.9.15 

sim.silent 

6.9.16 

sim.time 

6.9.17 


sim.error_count 

Indicates the number of errors that were flagged during the session. 


sim.error_handle_mode 

Indicates what action should be taken when the error occurs. 

The valid values are: 

-1 Suppress and ignore error message. 

0 Print the error but ignore its occurrance (i.e. the sim.error_count is not incremented 
and the simulation continues). 

1 Print the error, increment sim.error_count and halt simulation if simulation is in 
progress. 

2 Print the error, increment sim.error_count and halt simulation and command line/ 
script file execution any is in progress. 

3 Print the error, increment sim.error_count, halt all execution and then exit the 
simulator. The default value is 2. 
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| 6.9.3 sim.core_clk_cycle 

| Indicates the current number of core clock cycles simulated. 

| 6.9.4 sim.core_clk_freq 

| Indicates the core clock frequency (in MHz). 

| 6.9.5 sim.core_clk_period 

| Indicates the number of simulation time units specified for a core clock cycle. 

| 6.9.6 sim.fbus_clk_cycle 

| Indicates the current number of fbus clock cycles simulated. 

| 6.9.7 sim.fbus_clk_freq 

| Indicates the fbus clock frequency (in MHz). 

| 6.9.8 sim.fbus_clk_period 

1 Indicates the number of simulation time units specified for an fbus clock cycle. 


| 6.9.9 sim.goto_and_ubreak_key_on_p1 

This state is relevant to the "goto", "ubreak" and "go ’fbox/ctx’" commands. It indicates whether to 
stop simulation by examining P1 uword state or P3 uword state. P3 state is desired in most cases. 
P1 state will stop simulation earlier in the pipeline, but may "falsely" stop because the P1 uword 
may become aborted in P2 or P3. 


| 6.9.10 sim.halt 

This state is normally 0. If the user sets it to 1, the model halts (if running) at the end of the current 
cycle. This is useful in watch statements when it is desired for the model to be halted when a 
specific condition has been met. Note that this state must be reset to 0 in order to continue running 
the model. 


| 6.9.11 sim.pci_clk_cycle 

| Indicates the current number of pci clock cycles simulated. 


j 6.9.12 sim.pci clk freq 

| Indicates the pci clock frequency (in MHz). 
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sim.pci_clk_period 

Indicates the number of simulation time units specified for an pci clock cycle. 

s i m . post_s i m_exec_o rd e r 

Indicates the order in which watches, callbacks and the foreign_model_post_sim routine are called 
after each transactor simulation event is executed. Because watches, callbacks and 
foreign_model_post_sim offer the user 3 different mechanisms to either actively change state, and/ 
or passively observe state, the possibility arises that the execution order of these mechanisms may 
cause incorrect behavior. For example, performing passive reads (e.g. informational debug 
statements) prior to an active state change could cause incorrectly display debug data; or the order 
in which active state changes are evaluated could cause incorrect behavior. 

This switch allows the execution order of these 3 mechanisms to be set based upon the user-defined 
application of these 3 mechanisms. Using the notation: W (watches), C (callbacks) and P 
(foreign_model_post_sim), the legal values for this switch are: 0: W-C-P, 1: W-P-C, 2: C-W-P, 3: 
C-P-W, 4: P-W-C, 5: P-C-W. The default value is W-C-P. 

sim.prune_prefix_comments 

This state is normally 0. When set to 1 , ucode comment lines are pruned so that pure comment lines 
are not displayed— only lines with actual ucode descriptive text are displayed. 


sim.silent 

This state is normally 0. If the user sets it to 1, all debug information is suppressed. 


sim.time 

Represents current simulation time. 
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Foreign Model simulation extension is a useful tool for simulating external hardware devices, and, 
in development StrongARM core software. It acts as an extension to the capabilities of Transactor, 
which is a cycle and data accurate software model of IXP1200. Section 7.1 provides an overview 
of where foreign model simulation can be used. Section 7.2 describes how to integrate foreign 
models with the Transactor. Section 7.3 discusses the simulation of software modules running on 
the StrongARM Core. Details of simulating IX Bus devices are discussed in Section 7.4. 

Section 7.5 contains some sample code. 


7.1 Overview 

There are three reasons to use Foreign Model simulation: 

1. To interface hardware device models, 

2. To generate traffic on external busses of IXP1200, and, 

3. To perform rapid prototyping of StrongARM Core software modules. 

These three are illustrated in Figure 7-1. 

Figure 7-1. Three Uses of Foreign Models 



Interfacing Generating Traffic On Intel StrongARM Core 

Hardware Device External Busses of the Software Prototyping 

Model Intel® IXP1 200 Core 

Processor 


* Other names and brands may be claimed as the property of others. 
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• Interfacing hardware device models. Foreign modeling allows integration of models of 
external hardware such as a MAC device or custom chip that is connected to the IX Bus. This 
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could be a software model of the extemal device or a design in a hardware simulator such as 
Verilog. This includes the ability to interface with hardware models (such as a Verilog model) 
which could reside on a remote machine. 

• Generating traffic on external busses. Microengine software designers can use a foreign 
model to assist in the design and debugging of Microengine software modules by producing 
generic transactions of the IX Bus. This way, hardware residing on the IX Bus such as a MAC 
device or some custom chip can be simulated. Once the software is designed, the same foreign 
model interface can be used to produce the traffic typical for the application. This assists in 
estimating the performance of software. 

• StrongARM Software Module Prototyping. The Foreign model interface can also be used to 
develop the software that will run on the StrongARM Core. Even though StrongARM 
software executes on a development machine, once it interfaces to the Transactor through the 
Transactor API, execution is cycle accurate. This reduces the simulation time and allows 
accurate verification of interactions between StrongARM and Microengine software. 


7.2 Integrating Foreign Models with the Transactor 

A foreign model provides a mechanism by which the software model of the IXP1200 (Transactor) 
can be extended to include additional software models of hardware that interfaces with the 
IXP1200. There are three different ways to integrate a foreign model with the Transactor. 

• Foreign Model Dynamic-link Library (DLL): Used when the foreign model is running on 
the same Microsoft Windows system as the Transactor, and the user chooses to use the 
Developer’s Workbench Graphical User Interface. 

• Integrated Executable: Used when the foreign model is running on the same system as the 
Transactor, and the user chooses to use the command line interface rather than the Developers 
Workbench Graphical User Interface. 

• Remote Foreign Model Executable: Used to interface a hardware simulator (VHDL or 
Verilog) running on Unix to the Transactor and the Developer’s Workbench (which run on 
WindowsNT). 

To integrate the foreign model, the Transactor calls a foreign model at five stages of simulation: 

• Immediately after the Transactor has initialized the IXP1200 model, 

• Before a simulation step occurs, 

• After a simulation step has occurred, 

• When the simulation is reset, and 

• When the Transactor exits. 

The foreign model must provide five foreign model functions corresponding to these five calls. The 
foreign model interacts with the Transactor through the Transactor API, described in the file xact.h. 
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7.2.1 Foreign Model Dynamic-Link Library (DLL) 

This section describes how to create a dynamic-link library (DLL) for a foreign model simulation 
extension. The DLL is used in conjunction with the Transactor DLL when running the IXP1200 
Developer Workbench. The Workbench, Transactor, and foreign model interact as shown in 
Figure 7-2. 

Figure 7-2. Workbench, Transactor, and Foreign Model Interaction 



1 . The Workbench requests from the foreign model the pointers to foreign model functions 
through the foreign model API. 


2. The foreign model replies with the function pointers. 

3. The Workbench passes the pointers to the Transactor through the Transactor API. 

4. As the Workbench controls the Transactor through the Transactor API, the Transactor notifies 
the foreign model whenever: 

a. The Workbench is initialized, 

b. Before a simulation step occurs (preSim), 

c. After a simulation step has completed (postSim), 

d. The simulation is reset (i.e., a sim_reset command is executed), and 

e. When the Workbench exits debug mode and releases the Transactor. 

5. The foreign model interacts with the Transactor using the Transactor API. 

The foreign model DLL must provide the exported function GetForeignModelFunctions(), that the 
Workbench calls to get the addresses of the five functions that the Transactor calls to interact with 
the foreign model. The Workbench registers these functions with the DLL version of the 
Transactor. 

The foreign model DLL runs in conjunction with the DLL version of the Transactor, so xact_dll.h 
must be included in the foreign model DLL source files, if needed, and it must be linked against 
xact_dll.lib. 
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To specify that the DLL simulator is to be used as an extension to the Transactor model in the 
Workbench, select Debug > Simulator Options then select the Configuration tab. Select Local 
Simulation and check the Use simulator extension option. Finally, type the file name for your 
foreign Model DLL into the field provided, or browse for it by clicking on the '. . .' button. 

7.2.2 Integrated Executable (Integrated Transactor and Foreign 
Model) 

This section describes how to create an executable containing both the Transactor and a foreign 
model simulation extension. The foreign model and Transactor interact the same as the DLL except 
that the pointers to the foreign model API function calls are determined at compile time. The 
Transactor header file xact.h must be included in all files that call the Transactor API. Any object 
modules must be linked with xact_main.lib to create an executable. When the executable file is 
executed, the user can enter Transactor commands and any console commands that are defined in 
the foreign model using the command line interface (Figure 7-3). 

Figure 7-3. Command Line Interface 



7.2.3 Remote Foreign Model Executable 

The Remote Foreign Model uses the Open Network Computing Remote Procedure Protocol (ONC 
RPC) to interface the IXP1200 Developer Workbench and Transactor DLL (executing on an 
WindowsNT system) to a foreign model executing on another remote system. The advantage to 
remote simulation is that the foreign model can execute on other platforms such as a Sun 
Workstation running Solaris. 

ONC RPC makes it appear as though a foreign model executable calls a procedure located in a 
Transactor program. ONC RPC was originally designed by Sun Microsystems and is in the public 
domain. Intel provides a Microsoft Windows NT version of ONC RPC (OncRpc32.1ib) since the 
native support for RPC under Windows NT is different than ONC RPC. 

The Workbench and Transactor are WindowsNT applications that use the OncRpc32.1ib 
communications library to act as the communication layer between WindowsNT and UNIX, 
VxWorks, or other WindowsNT systems on the network. This communication library stands 
between user application and Wsock32. The Local and Remote Foreign Model Layers provide the 
RPC client and server functions between the Transactor and the remote foreign model. Intel 


7-4 


Development Tools User’s Guide 


inteh 


Figure 7- 


Intel® IXP1200 Network Processor Family 
Foreign Model Simulation Extensions 


provides sample source code for the foreign model layers on both the WindowsNT and remote 
sides. These files need to be modified to provide the specific functionality for each 
implementation. 


Figure 7-4 shows how the foreign model interface can be used to interface the IXP1200 
Workbench to a Foreign Model Application or a hardware model written in hardware language 
such as VHDL or Verilog. 


. Foreign Model Interface 



* Other names and brands may be claimed as the property of others. 
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As the figure shows, the Transactor calls a local foreign model layer function instead of the actual 
foreign model. The foreign model layer function converts the input parameters as needed into a 
standard network data representation format, and then calls functions in the runtime RPC library, 
OncRpc32.1ib, to send the request and its parameters to the remote foreign model. 

The remote foreign model performs the following steps to call the actual foreign model functions: 

1 . The OncRPC library runtime library functions accepts the request and calls the remote foreign 
model layer. 

2. The foreign model layer converts the parameters from the network transmission format to the 
format that the remote foreign function needs. 

3. The remote model foreign layer function invokes the remote foreign function. 
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The remote foreign model functions interact with the Transactor through the remote foreign model 
layer DLL (RS_Xact_DLL.DLL). The Xact API for the remote Transactor is defined in the header 
file rs_xact.h. The Transactor layer invokes the actual Transactor function via the OncRPC 
mechanism. 


7.3 Simulating StrongARM Core Applications 

The Developer’s Workbench can simulate a StrongARM Core application in conjunction with 
Microengine code. It supports the following methods for enabling the simulation: 

• Invoke the StrongARM hardware simulator in the Workbench and run the core image 

• Code the StrongARM Core application using Foreign Model techniques 

The first method is accomplished by specifying the name of the StrongARM Core image in the 
Simulation Options dialog selected from the Debug menu of the Workbench. A StrongARM Core 
image is comprised of the operating system (e.g., VxWorks) and the core application. The 
Workbench provides a cycle-accurate simulation engine of the IXP1200 StrongARM Core under 
which the StrongARM Core image executes. This approach results in a precisely simulated 
interaction between the StrongARM Core and the Microengines. However, the cycle-accurate 
model used to simulate the StrongARM Core hardware may significantly increase the overall 
execution time of a simulation, especially when large core applications are involved. Consequently, 
this method should only be used when the core application contains limited functionality, such as 
performing the hardware boot sequence. 

The second testing method uses the Transactor to provide a communication path between the 
StrongARM Core application and the Microengine code. While this technique does not result in a 
cycle-accurate model of the StrongARM Core application, it does provide a functionally accurate 
model of the interaction between the StrongARM Core and the Microengines while improving the 
overall simulation time. This section describes guidelines to code and build an application using 
Foreign Model interfaces that is targeted at both the StrongARM Core hardware and Transactor. 

This section covers the following topics: 

• Use Hardware Abstraction Layer (HAL) APIs 

• Determine the IOSTYLE compiler directive 

• Determine the coding considerations 

• Accessing Foreign Model Functions from the C Interpreter 

• Build the application to selected target format: Local Foreign Model or Remote Foreign Model 

7.3.1 Using the Hardware Abstraction Layer (HAL) 

The HAL API is documented in the IXP1200 Network Processor Software Reference Manual. The 
HAL API defines the function calls for accessing CSRs and functional unit memory such as 
SRAM, SDRAM and Scratchpad. To ensure portability of your StrongARM Core application 
between the hardware and the Transactor, the HAL must be used for memory access rather using 
direct memory-mapped reads and writes. 
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The HAL consists of set header files that define macros and function prototypes. These definitions 
provide mappings to the appropriate underlying target system - either the Hardware or the 
Workbench/Transactor. Compiler directives, in particular the IOSYTLE directive, control the 
underlying mapping. 

Determining IOSTYLE 

The IOSTYLE compiler directive controls how the HAL function calls and macros are compiled. 
All of the StrongARM Core application code must be built using the same IOSTYLE directive. 

There are three possible IOSTYLE definitions: 

IOSTYLE=HARDWARE Use this directive when building the core application to run on the 
StrongARM Core. HARDWARE directs the HAL to write to the memory-mapped addresses 
for functional unit memory and CSRs. If this directive is defined, you must also define the OS 
macro as either OS=NT, OS=VXWORKS, or OS=UCOS. 

IOSTYLE=AMBAIO Use this directive when building the core application to run under the 
Transactor. AMBAIO supports access to all functional unit memory and CSRs. AMBAIO 
simulates access to functional units via the AMB A Bus which bypasses command queues used 
by the Microengine. This models the actual behavior of the StrongARM hardware. 

IOSTYLE=XACTIO Use this directive when building the StrongARM Core application to 
run under the Transactor. Unlike AMB AIO, it does not allow access to all of the HAL 
functions. There is no access to CSRs or SRAM atomic functions when XACTIO is used, 

Coding Considerations 

Note the following when developing a StrongARM Core application that can be built as a Foreign 
Model: 

• The Foreign Model entry points must be included in the application so that the Transactor can 
call them. Additionally, the function GetForeignModelFunctions() must be provided if 
creating the Foreign Model as a Windows NT DLL. Refer to Section 6.4.1 for a description of 
these entry functions. The compiler directive ext_model_port can be specified to 
automatically generate the extemal references to the Foreign Model entry points. 

• Regardless of whether IOSTYLE is defined as XACTIO or AMBAIO, the function 
ambaloInitO must be called by the StrongARM Core application if it uses the Microengine 
library (ueng.lib). 

• The Transactor does not simulate IX Bus devices such as a MAC controller. If such modeling 
is required by the application, the device simulation must be provided separately, either in the 
form ofaC code library or using the C Interpreter scripting tool in the Workbench. See section 
6.2 for information on simulating an IX Bus device using Foreign Model techniques. 

• When writing large amounts of functional unit memory, as when initializing all of SDRAM, 
the AMBAIO versions of the write() functions may take a significant amount of execution 
time. Alternatively, the functions XactFastRead() or XactFastWrite()perform block 10. Use 
these functions instead, but only in the Foreign Model version of the StrongARM Core 
application. 

• The Transactor APIs (defined in xact.h) must only be used when running in simulation mode 
under control of the Transactor. Libraries built for any of the StrongARM Core operating 
systems do not support these calls. 
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7.3.4 Accessing Foreign Model Functions from the C Interpreter 

The C Interpreter is described in Section 6.5. The Interpreter supports a subset of the C 
programming language and is used to create and run scripts on behalf of the Workbench and 
Transactor. 

A StrongARM Core application using Foreign Model techniques can register function entry points, 
thus making them callable from a C script. To register an entry point in Simulation mode, use the 
XACT_register_console_function() call during initialization of the StrongARM Core application. 
This call is described in the IXP1200 Network Processor Software Reference Manual , Section 
3. 2.2. 5. 

Using a combination of scripts and Foreign Model code enables various configurations of the 
hardware and StrongARM Core application to be tested while not requiring a recompilation of the 
application code. Scripts can be written to initialize the state of the simulation, functional unit 
memory, and CSRs. They can also be written to simulate MAC devices to generate packet traffic 
on the IX Bus. 

7.3.5 Building the Application 

Once the design decisions are made, the following steps provide a guide to building the 
StrongARM Core application as a Foreign Model: 

• Determine if the StrongARM Core application will run as a Remote Foreign Model or Local 
Foreign Model. If using the Local Foreign Model the application must be built as a Windows 
DLL. If using the Remote Foreign Model, the target operating system must support ONC RPC. 
See section 6.1 for more details on Local and Remote Foreign Models. 

• The StrongARM Core application must include the header file xact.h. Additionally, use of the 
HAL API requires inclusion of the appropriate header files: hal_sram.h, hal_sdram.h and 
hal_fbi.h. 

• The Foreign Model application must link a minimal set of libraries consisting of: 
hal_1200.1ib, xact_dll.lib, xactio.lib and utils.lib. Other libraries are linked if used. For a 
description of the available libraries, see the IXP1200 Network Processor Software Reference 
Manual. 


7.4 Simulating IX Bus Devices 

Simulating of IX Bus devices involves the following: 

• Getting states of IX Bus pins, 

• Determining appropriate action based on the pin states, and 

• Setting the appropriate pin states 

The Transactor state names and a brief description of the states for various IX Bus pins is shown in 
Table 7-1. Section 3.3.4 (IX Bus Interface Pins) and Section 3.7 (IX Bus Decode Table) in the 
1XP1200 Network Processor Datasheet gives details of the usage of these pins. Timing diagrams 
showing the signal protocol can be found in Section 4. 3.7. 3 (IX Bus Protocol) and 4. 3. 7.4 
(RDYBus). Other Transactor states are described in Appendix A, “Transactor States”. 
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In order to read or write data into Transactor states, a handle to the state must be first obtained 
using the Transactor API call XACT_get_handle(char *state_name, -1) Note that the second 
argument for this call is an array index. Since the pins are not arrayed states -1 should be used as 
the second argument. If multiple devices are attached to the bus, then each device should added as 
a bus client using the XACT_add_bus_client( char *bus_name, char *bus_client_name) API call 
before the handle is obtained. This ensures that bus errors will be detected and reported. Bus errors 
occur when multiple bus clients are simultaneously driving the bus, or when client reads invalid 
data because the bus was not driven. Note that internally Transactor treats each of the states listed 
in Table 7-1 as a separate “bus”. Thus, each of these states require a separate call to add a bus 
client. 

Once a handle is obtained for the state (or bus client) XACT_get_state_value(XACT_HANDLE 
state_handle, unsigned int *value)and XACT_set_state_value(XACT_HANDLE state_handle, 
unsigned int *value)can be used to read and write to the bus. 

The device that is simulated needs to perform the following operations: 

• Check which port is selected for driving ready flags and put out the appropriate ready flags on 
the Ready Bus. 

• Check if flow control is being asserted and read the Ready Bus to obtain the ports for which 
flow control is asserted. 

• Read port control outputs to determine which device is selected to drive (for receives by 
IXP1200) or sink (for transmits by IXP1200) and appropriately drive or sink the bus. 

The set of pins that need to be driven or read from depends on the IX Bus mode selected. Please 
refer to the IXP1200 Network Processor Datasheet for details. 

The foreign model is called for every Transactor simulation clock cycle. The simulation clock 
cycle can be configured to either IX Bus clock or core clock. This can be selected on the 
Developer’s Workbench under Debug Simulator — » Options — » Configuration tab — » FIFO Bus 
Clock or Core Clock check box. The foreign model must drive/read the IX Bus pins in 
synchronization with the IX Bus clock. If the simulation is configured for IX Bus clock, no special 
synchronization is needed and reads/writes to the bus can performed in the post_sim() or pre-sim() 
calls in Foreign Model API (Section 6.5.1). 

If the simulation is configured for the Core clock, the foreign model should synchronize with the 
IX Bus clock using one of the following: 

• Use XACT_Define_Callback_State_Transition() with a handle to the sim.fbus_clk_cycle to 
register a function that is called for each IX Bus clock cycle. Read and writes to the bus are 
performed in this function. 

• Use XACT_clock_cycle_with_remainder() or XACT_clock_cycle() in pre_sim() or 
post_sim() Foreign Model functions to determine if the IX Bus clock has changed. Reads and 
writes to bus are performed in the post_sim() or pre-simQ calls in Foreign Model API. 

Table 7-1. Transactor Names for IX Bus Interface Pins 


Pin Name 

Transactor Name 

Description 

FDAT[31:0] 

fdatjo 

Lower 32 bits of the IX data bus 

FDAT[63:32] 

fdat_hi 

Upper 32 bits of the IX data bus 

FBE#[3:0] 

fbejoj 

Bi-directional byte enable bits <0:3> 

FBE#[7:4] 

fbe_hi_l 

Bi-directional byte enable bits <4:7> 
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Table 7-1. Transactor Names for IX Bus Interface Pins (Continued) 


Pin Name 

Transactor Name 

Description 

RXFAIL 

rx_fail 

Receive Packet Failure 

EOP 

eop 

End of Packet Indication 

SOP 

sop 

Start of Packet Indication 

EOP32_XMIT 

eop32_xmit 

Transmit End of Packet Indication 

SOP32_XMIT 

sop32_xmit 

Transmit Start of Packet Indication 

FAST_RX1 

fast_rx1 

Ready input from Fast Port 1 

FAST_RX2 

fast_rx2 

Ready input from Fast Port 2 

PORTCTL#[3:0] 

portctl_1 

Port Control outputs 

FPS[2:0] 

fps 

MAC Port Select outputs 

RDYBUS[7:0] 

rdybus 

Ready Bus l/O 

RDYCTL[3:0] 

rdyctl_1 

Ready control bits <0:3> 

RDYCTL[4] 

rdyctl_4 

Ready control bit <4> 

TKJN 

tokenjn 

Token in 

TK_OUT 

token_out 

Token out 

GPIO[3:0] 

gpio 

General Purpose 1/0 
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7.5 Sample Code 

The sections that follow contain some sample code. 

7.5.1 Creating A Foreign Model DLL Used with the Developer 
Workbench 

This procedure describes how to create a foreign model layer (DLL) to be used in the foreign 
model DLL configuration. 

• The foreign model DLL must provide the exported function GetForeignModelFunctions() in 
addition to the foreign_model_initialize(), foreign_model_pre_sim(), 
foreign_model_post_sim(), foreign_model_reset(), and foreign_model_exit() functions. 

• The file xact_dll.h must be included in foreign model DLL source files, if needed, and it must 
be linked against xact_dll.lib. 

7.5.1 .1 DLL Sample Code 

// You must include xact_dll.h, NOT xact.h in order to link correctly against 
// the DLL version of the Transactor. 

// 

#include "xact_dll.h" 

int f oreign_model_initialize ( ) 

{ 

...your initialization code... 
return (1) ; 

} 

int f oreign_model_pre_sim ( ) 

{ 

... your pre simulation event code... 
return (1) ; 

} 

int f oreign_model_post_sim ( ) 

{ 

... your post simulation event code... 
return (1) ; 

} 

int f oreign_model_reset ( ) 

{ 

... your reset code... 
return ( 1) ; 

} 

int f oreign_model_exit ( ) 

{ 

... your exit code... 
return ( 1) ; 

} 
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/* 

GetForeignModelFunctions 

This function is exported as the sole entry point into the DLL version 
of this package . The Developer Workbench calls it in order to get the 
foreign model entry points for the Transactor. The Workbench then 
registers these entry points with the Transactor. 

returns : 
uses : 
modif ies : 

*/ 

#if defined( cplusplus) 

extern "C" // the exported function must be of generic C type (not CPP) , 

// so that its name doesn't get adorned. 

#endif 

declspec (dllexport ) void cdecl 

GetForeignModelFunctions ( 

int ( **ForeignModelInitialize) (), 
int ( **ForeignModelPreSim) (), 
int ( **ForeignModelPostSim) (), 
int ( **ForeignModelReset ( ) , 
int ( **ForeignModelExit ) ()) 

{ 

*ForeignModelInitialize = f oreign_model_initialize ; 

*ForeignModelPreSim = f oreign_model_pre_sim; 

*ForeignModelPostSim = f oreign_model_post_sim; 

*ForeignModelExit = f oreign_model_exit ; 

*ForeignModelReset = f oreign_model_reset ; 

} } 

7.5.2 Creating A Remote Foreign Model - Local Foreign Model 
Layer 

The procedure that follows describes how to create a Local and Remote Foreign Model layer 
(DLL) to be used in the Remote Foreign Model Executable configuration. The procedure is the 
same used to create a local foreign model DLL in the Foreign Model Dynamic-Link Library (DLL) 
configuration with the addition of the following steps. 

• OncRpb32.1ib and Wsock32.1ib must also be linked. 

• Rs_xact.h must be included in the source files. 

• OncRpc32Init() must be called before making any OncRpc calls, and call OncRpc32Cleanup() 
before exit. 

7.5.2.1 Sample Code 

/* 

f oreign_model_initialize 

This sample function calls the OncRpc32Init to initialize the network layers, 
register a local foreign model function that performs the remote network 
initialization . It invokes the local rs_f oreign_model_initialize ( ) stub function 
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which then calls clnt_call(), a OncRpc32 library function to send a request to the 
remote foreign model application to execute the actual f oreign_model_initialize ( ) 
f unction . 

*/ 

int f oreign_model_initialize ( ) 

{ 

OncRpc32Init ( ) ; 

if ( ! XACT_register_console_f unction ( "Remotelnit " , Remotelnit, 1, 1) ){ 

fprintf (stderr , "XACT_register_console_f unction ( ) failed\n") ; 
return (0) ; 

} 

rs_f oreign_model_initialize ( ) ; 
return ( 1) ; 

} 

/* 

f oreign_model_pre_sim 

This function calls a local rs_f oreign_model_pre_sim stub function which then calls 
clnt_call(), a OncRpc32 library function to send a request to the remote foreign 
model application to execute the actual f oreign_model_pre_sim ( ) function. 

*/ 

int f oreign_model_pre_sim ( ) 

{ 

rs_f oreign_model_pre_sim ( ) ; 
return ( 1) ; 

} 

/* 

f oreign_model_post_sim 

This function calls a local rs_f oreign_model_post_sim stub function which then 
calls clnt_call(), an OncRpc32 library function to send a request to the remote 
foreign model application to execute the actual f oreign_model_post_sim ( ) function. 

*/ 

int foreign_model_post_sim ( ) 

{ 

rs_f oreign_model_post_sim ( ) ; 
return ( 1) ; 

} 

z* 

f oreign_model_post_sim 

This function calls a local rs_f oreign_model_reset stub function which then calls 
clnt^callO, an OncRpc32 library function to send a request to the remote foreign 
model application to execute the actual f oreign_model_reset ( ) function. 

*/ 

int f oreign_model_reset ( ) 

{ 

rs_f oreign_model_reset () ; 
return ( 1) ; 

} 

/* 

f oreign_model_exit_sim 

This function calls a local rs_f oreign_model_exit stub function which then calls 
clnt_call () , a OncRpc32 library function to send a request to the remote foreign 
model application to execute the actual f oreign_model_exit_sim () function. 
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*/ 

int f oreign_model_exit ( ) 

{ 

rs_f oreign_model_exit () ; 

OncRpc32Cleanup ( ) ; 
return ( 1) ; 

} 

7.5.3 Creating a Remote Foreign Model - Remote Foreign Model 
Layer 

The procedure that follows describes how to create a Remote Foreign Model Layer (DLL) to be 
used in the Remote Foreign Model Executable configuration. If you choose to create a server 
thread that will get a transport handle used for receiving and replying to remote foreign model 
calls, the foreign model must be linked against rs_xact_dll.lib, OncRpc, and socket libraries and 
rs_xact.h must be included in the source files. 

7.5.3.1 Sample Code 

/* 

* The remote version of " rs_f oreign_model_initialize " 

* you must call ConnectionToXact () to establish the connection with Transactor 
before you make any *Transactor function calls. 

*/ 



int * 

rs_f oreign_model_initialize () 

{ 

static int result =1; /* must be static! */ 

RS_XACT_HANDLE hSimTime; 

/* 

* 

* *XactServer is the hostname where the Workbench is running on 
*/ 

if (ConnectionToXact ( *XactServer) != RS_SUCCESS) { 
printf ( "open_connection failed\n") ; 
result=0 ; 

} 

/* 

* For example, you are making a Transactor call 
*/ 

hSimTime = RS_XACT_get_handle ( " sim . t ime " , -1); 

if (hSimTime == RS_INVALID_XACT_HANDLE ) 

printf ( "ErrorError - RS_XACT_get_handle failed\n"); 

... your initialization code 

return &result; 

} 
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/* 

* The remote version of " rs_f oreign_model_pre_sim" 
*/ 

int * 

rs_f oreign_model_pre_sim ( ) 

{ 

static int result=l; /* must be static! */ 

... your pre simulation event code 
return (&result) ; 


} 

/* 

* The remote version of " rs_f oreign_model_post_sim" 
*/ 

int * 

rs_f oreign_model_post_sim ( ) 

{ 

static int result=l; /* must be static! */ 

... your pre simulation event code 
return (&result) ; 
int * 

rs_f oreign_model_reset () 

{ 

static int result=l; /* must be static! */ 

... your reset code 

return (&result) ; 


} 

/* 

* The remote version of " rs_f oreign_model_exit " 
*/ 

int * 

rs_f oreign_model_exit () 

{ 

static int result=l; /* must be static! */ 

... your exit code 
return (&result) ; 

} 
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A.1 About States 

The IXP1200 Transactor contains internal states that define the overall state of the model. The 
examine command with the asterisk wildcard character (examine *) can be used to view all the 
model states. This section describes only the most commonly used model states. States can be 
grouped into three categories: 

• Hardware states. Affect SRAM, SDRAM, registers, FIFOs, etc. 

• Simulator states. Affect simulator functions such as debugging and error reporting, starting 
and stopping the Transactor, etc. 

• Statistics states. Affect the reporting of SRAM, SDRAM, FBus, and Microengine performance 
statistics. 

States can be read and written by the user using the examine and deposit Transactor commands. 
Any simple model state (i.e., a signal, register, or array (not a FIFO)) is also treated as a global int 
when it appears in a C statement or expression. States can be preserved and recalled using the save 
and restore Transactor commands. 

Table A-1 is a quick reference to the IXP1200 Transactor states described in this chapter: 

Table A-1. IXP1200 Transactor States 


State Name 

State Format 

Page 

Hardware States 

Microengine GPR or Transfer Register 

{chipname}.fx.reg.register_name_thd 

A-5 

Microengine Control Store 

{chipname}.fx.ctl.ustore{[addr]<msb:lsb>} 

A-6 

Microengine Condition Codes 

{chipname}.fx.ctl.condition_code 

A-7 

Microengine Microstore Data Register 

{chipname}.fx.ctl.csr_ustore_rd_data 

{chipname}.fx.ctl.csr_ustore_wr_data 

A-8 

Microengine Microstore Address Register 

{chipname}.fx.ctl.csr_ustore_rd_address 

{chipname}.fx.ctl.csr_ustore_wr_address 

A-8 

Microengine Thread Program Counter 
Register 

{chipname}.fx.ctl.pc_ctx_x 

A-9 

Enabled Thread Wake-Up Signals 

{chipname}.fx.ctl.thread_trigger_mask_x 

A-10 

Active Thread Wake-Up Signals 

{chipname}.fx.ctl.enabled_signals_x 

A-11 

Transmit and Receive FIFOs 

{chipname}.fbi.rfifo{[addr]<msb:lsb>} 

{chipname}.fbi.tfifo{[addr]<msb:lsb>} 

A-12 

FBI CSRs 

{chipname}.fbi.csr{[addr]<msb:lsb>} 

A-13 

FBI Scratchpad Memory 

{chipname}.fbi.scratch_pad{[addr]<msb:lsb>} 

A-15 

SRAM 

{chipname}.sram{[addr]<msb:lsb>} 

A-1 6 

SRAM Push/Pop Registers 

{chipname}.sc.push_pop_regs{[addr]<msb:lsb>} 

A-17 

SDRAM 

{chipname}.sdram{[addr]<msb:lsb>} 

A-18 
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Table A-1. IXP1200 Transactor States (Continued) 


State Name 

State Format 

Page 

Simulation States 

Specify Microengine(s) for GOTO 

{chipname}.art.fbox_mask 

A-1 9 

Specify Thread(s) for GOTO 

{chipname}.fx.art.ctx_mask 

{chipname}.art.ctx_mask 

A-20 

Report Core Clock Cycles 

sim.core_clk_cycle 

A-20 

Core Clock Frequency 

sim.core_clk_freq 

A-21 

Core Clock Period 

sim.core_clk_period 

A-21 

Report FBus Clock Cycles 

sim.fbus_clk_cycle 

A-21 

FBus Clock Frequency 

sim.fbus_clk_freq 

A-22 

FBus Clock Period 

sim.fbus_clk_period 

A-22 

Report PCI Clock Cycles 

sim.pci_clk_cycle 

A-22 

PCI Clock Frequency 

sim.pci_clk_freq 

A-23 

PCI Clock Period 

sim.pci_clk_period 

A-23 

Execution Order 

sim.post_sim_exec_order 

A-24 

Report Error Count 

sim.error_count 

A-24 

Error Flandle Mode 

sim.error_handle_mode 

A-25 

Stop Simulation on P1 or P3 

sim.goto_and_ubreak_key_on_p1 

A-25 

Halt Simulation 

sim.halt 

A-26 

Suppress Comments 

sim.prune_prefix_comments 

A-26 

Suppress Debug Information 

sim.silent 

A-27 

Report Simulation Time 

sim.time 

A-27 

Specify Debug Verbosity Level 

{chipname}.unit.art.debug 

A-28 

Specify Reported Execution Stages 

{chipname}.fx.art.debug_px 

A-29 

Statistics States 

Compute Cycles 

{chipname}.fx.stat.compute_cycles 

A-32 

SDRAM Read Latency 

{chipname}.fx.stat.sdram_read_latency 

A-33 

SRAM Read Latency 

{chipname}.fx.stat.sram_read_latency 

A-33 

SRAM Read Lock Latency 

{chipname}.fx.stat.sram_read_lk_latency 

A-34 

Thread PC During Idle Cycle 

{chipname}.fx.stat.threadx_pc_during _idle_cycles 

A-34 

Thread Latency 

{chipname}.fx.stat.thread_latency 

A-35 

Time Slice 

{chipname}.fx.stat.time_slice_threadx 

A-36 

Time Slice Thread Idle 

{chipname}.fx.stat.time_slice_thread_idle 

A-36 

SDRAM Bandwidth 

{chipname}.dc.stat.bandwidth 

A-37 

SDRAM Even BankQueue Fullness 

{chipname}.dc.stat.even_bank_queue_fullness 

A-37 

SDRAM Odd Bank Queue Fullness 

{chipname}.dc.stat.odd_bank_queue_fullness 

A-38 

SDRAM OrderQueue Fullness 

{chipname}.dc.stat.order_queue_fullness 

A-38 

SDRAM Priority Queue Fullness 

{chipname}.dc.stat.priority_queue_fullness 

A-39 


A-2 
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State Name 

State Format 

Page 

SRAM Bandwidth 

{chipnamefsc.stat.bandwidth 

A-39 

SRAM Order Queue Fullness 

{chipname}.sc.stat.order_queue_fullness 

A-40 

SRAM Priority Queue Fullness 

{chipname}.sc.stat.priority_queue_fullness 

A-40 

SRAM Read Lock Queue Fullness 

{chipname}.sc.stat.rd_lk_queue_fullness 

A-41 

SRAM Read Queue Fullness 

{chipname}.sc.stat.read_queue_fullness 

A-41 

SRAM State Machine Distribution 

{chipname}.sc.stat.state_machine_dist 

A-42 

Command Bus Bandwidth 

{chipname}sc.stat.cmd_bus_bandwidth 

A-42 

SBUS Pull Bus Bandwidth 

{chipname}.stat.sbus_pull_bandwidth 

A-43 

SBUS Push Bus Bandwidth 

{chipname}.stat.sbus_push_bandwidth 

A-44 

SDRAM Pull Bus Bandwidth 

{chipname}.stat.sdram_pull_bandwidth 

A-45 

SDRAM Push Bus Bandwidth 

{chipname}.stat.sdram_push_bandwidth 

A-46 


A.1.1 State Definition Format 

This section lists the most commonly used Transactor states in alphabetical order and describes 
each one. The state definitions in the sections that follow contain: 

• The state name (e.g., {chipname}.fx.reg.register_name_thd). 

• A description of the state. 

• A description of the parameters, if any, associated with the state. 

• One or more examples illustrating the use of the state. 

Optional input strings are delimited by bracket characters ({ }) in these descriptions. 

Bolding indicates a predefined, required part of the state definition. 
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A.1.2 


Display Formats for Statistics States 


Statistics states are used with the examine command to obtain microcode performance 
information. Depending on the state, statistics are reported in one of two formats. 


Format 1: 

samples = 12; min = 17; ave = 20; max = 36; data units = cycles 
sample distrib | 4 | 5 | 1 | 1 | 1 | 

percent | 3 3 % | 4 2 % | 8% | 8% | 8%| 

cumul percent | 33% | 75% | 83% | 92% | 100% | 
cycles | 17 | 18 | 24 | 30 | 36 | 

The first line of text indicates the following: 

samples = The total number of samples taken for these statistics. 

min = The minimum number (of cycles, in this case). 

ave = The average number (of cycles, in this case). 

max = The maximum number (of cycles, in this case). 

data units = The units in which the data (min, ave, and max) is expressed. 

The table shows the distribution of samples by category. In this case, samples are categorized by 
cycle count. The 12 samples taken for these statistics fall into five categories of cycle counts: 17, 
18, 24, 30, and 36. Four samples had a cycle count of 17, five had a cycle count of 18, and so on. 
The table contains the following information: 

sample distrib = The number of samples in each category. 

percent = The percentage of samples in each category. 

cum percent = The cumulative percentage of samples by category. 

cycles = Category. In this case, samples are categorized by cycle count. 


Format 2: 


samples = 24; min = 0; ave 
ctx 0 non-aborted cycles : 
ctx 0 aborted cycles : 
ctx 0 stalled cycles : 
ctx 1 non-aborted cycles : 
ctx 1 aborted cycles : 
ctx 1 stalled cycles : 
ctx 2 non-aborted cycles : 
ctx 2 aborted cycles : 
ctx 2 stalled cycles : 
ctx 3 non-aborted cycles : 
ctx 3 aborted cycles : 
ctx 3 stalled cycles : 
no ctx active cycles : 


6 

1 

0 

6 

0 

0 

6 

0 

0 

5 

0 

0 

0 


max = 9; data units = cycles 
(25%) ************ 

(4%) ** 

( 0 %) 

(25%) ************ 

( 0 %) 

( 0 %) 

(25%) ************ 

( 0 %) 

( 0 %) 

( 21 %) ********** 


( 0 %) 


( 0 %) 

( 0 %) 


Format 2 categorizes samples (in this case) according to context and cycle type. The information in 
the first line is identical to that of Format 1. The table, however, features category in column 1, the 
number of samples in each category in column 2, the percentage of samples in each category in 
column 3, and a graphical representation (horizontal bar chart) of the distribution of samples in 
column 4. 
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Hardware States 

Microengine GPR or Transfer Register 

Used with the deposit and examine commands. 

Format: { chipname } . f x . reg . register_name_thd 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

f x The Microengine number, where x specifies the number. Valid 

Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). You 
can use the wildcard notation f* with the deposit/multi instruction to 
specify all Microengines. 

reg Constant that specifies this is a register state. 

register_name_thd 

The name of the register followed by the thread number. The thread 
number, can be 0, 1, 2, or 3. Can appear in one of three forms, where x 
is the thread number: 

• For GPRs: regname_x (e.g., reg0_l for the GPR named regO 
associated with thread 1) 

• For SRAM transfer registers: $regname_rd_x or $regname_wr_x 
(e.g., $reg0_rd_l for the SRAM read transfer register named regO 
associated with thread 1). 

• For SDRAM transfer registers: $$regname_rd_x or 
$$regname_wr_x (e.g., $$reg0_wr_l for the SDRAM write 
transfer register named regO associated with thread 1). 

Example 1: > deposit f 0 . reg . $val_rd_0 = Oxffff 

Deposit some data into an SRAM transfer register named $val_rd. Chip has a null (no) name. We 
want Microengine 0, thread 0. 

To examine the data: > examine f 0 . reg . $val_rd_0 

Example 2: > examine chipl . f 0 . temp_0 

Examine a GPR named temp in a chip named chipl. Examine Microengine 0, thread 0. 
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A.2.2 Microengine Control Store 

Used with the examine command. The Microengine control store is an array of 128 longwords. 

Format: { chipname } . f x . ctl . ustore { [addr] <msb : lsb> } 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

f x The Microengine number, where x specifies the number. Valid 

Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

ctl Constant that specifies this is a model control signal. 

ustore{ [addr] <msb:lsb>} 

If [addr] is used, it specifies an offset into the program store. Valid values 
are 0 to 1023. Single locations are specified by a single value (e.g., [0]). 
A range of locations is specified by using maximum and minimum 
values separated by a colon (e.g., [1023:0]). Bits within a longword can 
be specified by <msb:lsb>. If [addr] is not used, information on the 
number of valid words in the control store and the file from which the 
control store was loaded are displayed. 

> examine f 0 . ctl . ustore 

Examine the control store without specifying an [addr] . Example result: 

f 0 . ctl . ustore : ustore of 1024 32-bit words ; 23 words 

currently valid. 

Ucode loaded from: " llist . list " ; contains 1 pages 

> ex f 0 . ctl . ustore [0] 

Examine a single location in the control store. 

> ex f 0 . ctl . ustore [3 : 0] 

Examine locations 3 through 0 in the control store. 


Example 1: 

Example 2: 
Example 3: 
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Microengine Condition Codes 

Used with the examine and deposit commands. There are three single bit condition codes: Carry, 
Negative, and Zero. A condition code is set to 1 when its corresponding condition occurs. 

Format: { chipname } . f x . ctl . condition_code 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

f x The Microengine number, where x specifies the number. Valid 

Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). You 
can use the wildcard notation f* with the deposit/multi instruction to 
specify all Microengines. 

ctl Constant that specifies this is a model control signal. 

condition_code 

Condition code name. Valid names are: 

cc_carryCarry 

cc_negNegative 

cc_zeroZero 

Example 1: > examine f 0 . ctl . cc_neg 

Examine the Negative condition code. Example result indicating 0 as the 
Negative condition code: 
f 0 . ctl . cc_neg<0> : 0x0 

Example 2: > examine f 0 . ctl . cc_neg 

Examine the Carry condition code. Example result indicating 1 as the 
Carry condition code: 
f 0 . ctl . cc_carry<0> : 0x1 
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A.2.4 


Microengine Microstore Data Registers 


Used with the examine and deposit commands. Each Microengine has a 32-bit microstore data 
read register and a 32-bit microstore data write register, each of which has its own state definition. 

Formats: { chipname } . f x . ctl . csr_ustore_rd_data 

{ chipname } . f x . ctl . csr_ustore_wr_data 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


fx 


ctl 


The Microengine number, where x specifies the number. Valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). You 
can use the wildcard notation f* with the deposit/multi instruction to 
specify all Microengines. 

Constant that specifies this is a model control signal. 


csr_ustore_rd_data 

Specifies the read microstore data register. 


csr_ustore_wr_data 

Specifies the write microstore data register. 

Example: > ex f 1 . ctl . csr_ustore_rd_data 

Examine the microstore data read register of Microengine 1 . 


A.2.5 


Microengine Microstore Address Registers 


Used with the examine and deposit commands. Each Microengine has a 10-bit microstore address 
read register and a microstore address write register, each of which has its own state definition. 

Formats: { chipname } . f x . ctl . csr_ustore_rd_address 

{ chipname } . f x . ctl . csr_ustore_wr_address 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


fx 


ctl 


The Microengine number, where x specifies the number. Valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). You 
can use the wildcard notation f* with the deposit/multi instruction to 
specify all Microengines. 

Constant that specifies this is a model control signal. 


c s r_us t or e_rd_addr es s 

Specifies the read microstore address register. 


csr_ustore_wr_address 

Specifies the write microstore address register. 

Example: > ex f 1 . ctl . csr_ustore_rd_address 

Examine the microstore address read register of Microengine 1 . 
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Microengine Thread Program Counter Register 


Used with the examine and deposit commands. Each Microengine has four 10-bit thread program 
counter registers. 


Formats: 

chipname 

f x 


ctl 

pc_ctx_x 


Example: 


{ chipname } . f x . ctl . pc_ctx_x 

An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

The Microengine number, where x specifies the number. Valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). You 
can use the wildcard notation f* with the deposit/multi instruction to 
specify all Microengines. 

Constant that specifies this is a model control signal. 

Thread program counter register. Valid names are: 

• p c_c t x_ 0 Program counter register for thread 0 . 

• pc_ctx_l Program counter register for thread 1 . 

• pc_ctx_2 Program counter register for thread 2. 

• pc_ctx_3 Program counter register for thread 3. 

> ex f 0 . ctl . pc_ctx_l 

Examine the program counter register for thread 1 of Microengine 0. 
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A.2.7 Enabled Thread Wake Up Signals 

Used with the examine and deposit commands. This state involves an 11-bit mask, each bit of 
which corresponds to a signal from one of the following sources: 

BitSource 

Oself (current Microengine) 

1SRAM 

2SDRAM 

3Interthread 1 

4Interthread 2 

5Receive request available 

6FBI 1 

7FBI2 

8Sequence number 1 
9Sequence number 2 
10PCI 


When a bit in the bit mask is set, that source is allowed to wake up a thread. When a bit is cleared, 
that source can not wake up a thread. 


Formats: 

{ chipname } . fx . ctl . thread trigger mask x 

chipname 

An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

fx 

The Microengine number, where x specifies the number. Valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). You 
can use the wildcard notation f* with the deposit/multi instruction to 
specify all Microengines. 

ctl 

Constant that specifies this is a model control signal. 

thread trigger 

mask x 

Each thread can have its own mask. Valid names are: 


• thread trigger mask 0 Mask for thread 0. 

• thread trigger mask 1 Mask for thread 1 . 

• thread trigger mask 2 Mask for thread 2. 

• thread trigger mask 3 Mask for thread 3. 

Example 1: 

> dep/multi f * . ctl . thread trigger mask* = 0x111 
Enable all threads in all Microengines to wake up as a result of a wake 
up signal from any source. 

Example 2: 

> dep/multi f * . ctl . thread trigger mask 0 = 0x0 
Disable thread 0 in all Microengines from being woken up by any 
source. 
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Active Thread Wake Up Signals 

Used with the examine and deposit commands. This state involves an 11-bit mask, each bit of 
which corresponds to a signal from one of the following sources: 

BitSource 

OSelf (i.e., the current Microengine) 

1SRAM 

2SDRAM 

3Interthread 1 

4Interthread 2 

5Receive request available 

6FBI 1 

7FBI2 

8Sequence number 1 
9Sequence number 2 
10PCI 


When a bit in the mask is set, that source is currently waiting to wake up a thread. When a bit is 
cleared, that source is not currently waiting to wake up a thread. 

Formats: { chipname } . f x . ctl . enabled_signals_x 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


fx 


ctl 

enabled_signals_x 


The Microengine number, where x specifies the number. Valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). You 
can use the wildcard notation f* with the deposit/multi instruction to 
specify all Microengines. 

Constant that specifies this is a model control signal. 

Each thread can have its own mask. Valid names are: 

• enabled_signals_0 Mask for thread 0. 

• enabled_signals_l Mask for thread 1 . 

• enabled_signals_2 Mask for thread 2. 

• enabled_signals_3 Mask for thread 3. 


Example: > ex f * . ctl . enabled_signals* 

Use wildcards to check what sources are currently waiting to wake up 
any thread in any Microengine. 
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A.2.9 Transmit and Receive FIFOs 


Used with the deposit and examine commands. Refers to an array of 128 quadwords in the FBI 
unit’s transmit and receive FIFOs. 

Format: { chipname } . fbi . rf if o{ [addr] <msb : lsb> } 

{ chipname } . fbi . tf if o{ [addr] <msb : lsb> } 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


f bi Constant that specifies the FIFO bus interface unit. 

rfifo{ [addr] <msb:lsb>} 

[addr] specifies a quadword offset into the receive FIFO array. Valid 
[addr] values are 0 to 127. Note that the beginning of one of the sixteen 
64-byte elements in the array occurs every eight quadwords. Bits within 
a quadword can be specified by <msb:lsb>. Deposits can only be 
performed for values of 32 bits or less. Examines can occur on 0 to 64 
bit values. If [addr] is omitted, the state refers to the FBI receive FIFO as 
a whole. 


tfifo{ [addr] <msb:lsb>} 

[addr] specifies a quadword offset into the transmit FIFO array. Valid 
[addr] values are 0 to 127. Note that the beginning of one of the sixteen 
64-byte elements in the array occurs every eight quadwords. Bits within 
a quadword can be specified by <msb:lsb>. Deposits can only be 
performed for values of 32 bits or less. Examines can occur on 0 to 64 
bit values. If [addr] is omitted, the state refers to the FBI transmit FIFO 
as a whole. 


Example 1: 


Example 2: 


> examine fbi . rf if o [0] <63 : 0> 
Examine the .... Example result: 


array : fbi . rf if o [0] <63 : 0> : 00000000 00000000 


> dep fbi . rf if o [0] <63 : 32 > = Oxffffffff 
Deposit the .... Example result: 

array : fbi . rf if o [0] <63 : 0> : FFFFFFFF 00000000 
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FBI CSRs 

Used with the deposit and examine commands. Refers to a 32-bit FBI CSR. 

Format: { chipname } . fbi . csr_name { <msb : lsb> } 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

f bi Constant that specifies the FIFO bus interface unit. 

c s rname { <msb : 1 sb > } 

Specifies the CSR name, as summarized in Table A-2. 

Table A-2. FBI CSRs 


Register Name 

csr_name 

IREG 

ireg 

SOP_SEQ1 

sop_seq1 

SOP_SEQ2 

sop_seq2 

ENQUEUE_SEQ1 

enqueue_seq1 

ENQUEUE_SEQ2 

enqueue_seq2 

THREAD_DONE_REGO 

thread_done1 

THREAD_DONE_REG1 

thread_done2 

THREAD_DONE_INCR1 

thread_done1 

THREAD_DONE_INCR2 

thread_done2 

RCV_RDY_CNT 

rec_ready_count 

RCV_RDY_HI 

rec_ready_bits_hi 

RCV_RDY_LO 

rec_ready_bits_lo 

RCV_RDY_CTL 

rec_ready_control 

RCV_REQ 

rec_req 

RCV_CNTL 

rec_ctl 

FLOWCTL_MASK 

fbus.flowctl_mask 

RDYBUS_TEMPLATE_CTL 

fbus.rdybus_template_ctl 

RDYBUS_TEMPLATE_PROG_1 

fbus.rdybus_template_ctl1 

RDYBUS_TEMPLATE_PROG_2 

fbus.rdybus_template_ctl2 

RDYBUS_TEMPLATE_PROG_3 

fbus.rdybus_template_ctl3 

RDYBUS_SYNC_COUNT_DEFAULT 

fbus.rdy_synch_count_default 

SELF_DESTRUCT 

self_destruct 

CYCLE_CNT_LO 

cycle_count_lsw 

CYCLE_CNT_HI 

cycle_count_msw 

HASH_M ULTIPLIE R_64_H 1 

hash_multiplier_64_hi 

HASH_MULTIPLIER_64_LO 

hash_multiplier_64_lo 

HASH_M ULTIPLIE R_48_H 1 

hash_multiplier_48_hi 

HASH_MULTIPLIER_48_LO 

hash_multiplier_48_lo 
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Table A-2. FBI CSRs (Continued) 


Register Name 

csr_name 

SEND_CMD 

fbus.sendq 

GET_CMD 

getq 

XMIT_RDY_LO 

xmit_ready_bits_lo 

XMIT_RDY_HI 

xmit_ready_bits_hi 

XMIT_RDY_CTL 

fbus.xmit_ctl 

XMIT_VALIDATE 

xmit_valid_bits 

XMIT_PTR 

fbus.frozen_xmit_valid_outptr 

FP_READY_WAIT 

fbus.fp1_wait_count_csr<3:0> 

fbus.fp2_wait_count_csr<3:0> 

REC_FAST_PORT_CTL 

f ast_po rt 1 _body_th read<4 : 0> 
f ast_po rt2_body_th read<4 : 0> 
fast_port1_header_thread<4:0> 
fast_port2_header_thread<4:0> 


Bits within a CSR can be specified by <msb:lsb>. If [addr] is omitted, the state refers to the FBI 
CSR as a whole. 

Example 1: 

Example 2: 


> dep fbi.csr[0] = Oxflflflfl 

Deposit a value into the THREAD_DONE_REGO FBI CSR. Example 
result: 

fbi.csr [0] <3 1 : 0 > : 32 

> ex fbi.csr[0] 

Examine the THREAD_DONE_REGO FBI CSR. Example result: 
fbi.csr [0] <3 1 : 0 > : FIFIFIFI 
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FBI Scratchpad Memory 

Used with the deposit and examine commands. Refers to the FBI scratchpad memory, which is an 
array of 128 quadwords. 

Format: { chipname } . fbi . scratch_pad{ [addr] <msb : lsb> } 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

f bi Constant that specifies the FIFO bus interface unit. 

scratch_pad{ [addr] <msb : lsb>} 

[addr] specifies an offset into FBI scratchpad. Valid [addr] values are 0 
to 1023. Single locations are specified by a single value (e.g., [0]). A 
range of locations is specified by using maximum and minimum values 
separated by a colon (e.g., [1023:0]). Bits within a quadword can be 
specified by <msb:lsb>. Deposits can only be performed for values of 32 
bits or less. Examines can occur on 0 to 64 bit values. If [addr] is omitted, 
the state refers to the FBI CSR as a whole. 

> dep fbi . scratch_pad [0] = Oxffffffff 

Deposit Oxffffffff into FBI scratchpad memory. Example result: 
fbi . scratch_pad [0] <31 : 0> : 32 

> ex fbi . scratch_pad [0] 

Examine the same location. Example result: 
fbi . scratch_pad [0] <31 : 0> : FFFFFFFF 


Example 1: 


Example 2: 
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A.2.12 SRAM 


Used with the deposit and examine commands. Refers to the SRAM array of longwords, the size 
of which is set when you initialize memory with the mem_init Transactor command. 

Format: { chipname } . sram{ [addr] <msb : lsb> } 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


sram{ [addr] <msb : lsb>} 

[addr] specifies a longword offset into SRAM. Valid [addr] values are 0 
to the amount in bytes specified in the mem_init Transactor command 
divided by 4 (since there are 4 bytes in one longword). Single locations 
are specified by a single value (e.g., [0]). A range of locations is specified 
by using maximum and minimum values separated by a colon (e.g., 
[1023:0]). Bits within an SRAM longword can be specified by 
<msb:lsb>.If [addr] is omitted, the state refers to SRAM as a whole. 


Example 1: 


Example 2: 


Example 3: 


> chip 

AA-1200 chip, was instantiated 

> mem_init sram lm 

> dep sram[0] = Oxffffffff 

memory : sram [0] <31 : 0> FFFFFFFF (-1) 

Instantiate a chip, use the mem_init command to set the size of SRAM, 
and deposit a value. The lines preceded by a prompt character (>) are the 
ones you type in. 

> ex sram[0] 

memory : sram [0] <31 : 0> FFFFFFFF (-1) 

Examine the result of Example 1 . 


> ex sram [0:4] 

After changing the contents of SRAM, examine the first five longwords. 


result: 



: sram [0] <31 : 0> 

00123456 

(1193046) 

: sram [1] <31 : 0> 

00123456 

(1193046) 

: sram [2] <31 : 0> 

0000000A 

(10) 

: sram [3] <31 : 0> 

00000005 

(5) 

: sram [4] <31 : 0> 

00000014 

(20) 
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SRAM Push/Pop Registers 

Used with the deposit and examine commands. Refers to any or all of eight 23-bit registers, each 
of which holds a pointer to the first element in a linked list in SRAM. 

Format: {chipname} . sc . push_pop_regs { [addr] <msb:lsb>} 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

sc Constant that specifies SRAM. 

push_pop_regs{ [addr] <msb:lsb>} 

[addr] specifies one of eight push/pop registers. Valid [addr] values are 
0 to 7. Single registers are specified by a single value (e.g., [0]). A range 
of registers is specified by using maximum and minimum values 
separated by a colon (e.g., [4:2]). Bits within an SRAM push/pop register 
can be specified by <msb:lsb>. If [addr] is omitted, the state refers to the 
entire array of push/pop registers. 

> dep sc . push_pop_regs [0] = Oxff 

Deposit a value into push/pop register 0. 

> ex sc .push_pop_regs [0] 

Examine the result of Example 1. Example display: 
array : sc . push_pop_regs [0] <22 : 0> 0000FF 


Example 1: 
Example 2: 
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A.2.14 SDRAM 


Used with the deposit and examine commands. Refers to the SDRAM array of quadwords, the size 
of which is set when you initialize memory with the mem_init Transactor command. 


Format: 


chipname 


{ chipname } . sdramj [addr] <msb : lsb> } 

An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 


sdram{ [addr] <msb : lsb>} 


[addr] specifies a quadword offset into SDRAM. Valid [addr] values are 
0 to the amount in bytes specified in the mem_init Transactor command 
divided by 8 (since there are 8 bytes in one quadword). Single locations 
are specified by a single value (e.g., [0]). A range of locations is specified 
by using maximum and minimum values separated by a colon (e.g., 
[1023:0]). Bits within an SDRAM quadword can be specified by 
<msb:lsb>. Deposits can only be performed for values of 32 bits or less. 
Examines can occur on 0 to 64 bit values. If [addr] is omitted, the state 
refers to SDRAM as a whole. 


AA-1200 chip, was instantiated 

> mem_init sdram lm 

> dep sdram[0] = Oxffffffff 
memory : sdram [0] <31 : 0> FFFFFFFF 

Instantiate a chip, use the mem_init command to set the size of SDRAM, 
and deposit a value. Then examine the result. The lines preceded by a 
prompt character (>) are the ones you type in. 


Example 1: 


> chip 


Example 2: 


> ex sdram[0] 

memory : sdram [0] <31 : 0> FFFFFFFF 
Examine the result of Example 1 : 
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Specify Microengine(s) for GOTO 


Used with the deposit and examine commands. A 6-bit value that specifies the Microengine(s) to 
which a GOTO command applies when used with a label or control store address. When GOTO 
executes, the Transactor runs until the specified Microengine(s) reach the label or address and 
ignores any Microengines that are not enabled. 

Format: { chipname } . art . f box_mask 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


art 

fbox mask 


Example 1: 


Example 2: 


Constant that specifies this is a model artifact. 

A six-bit mask that specifies which Microengine(s) should be enabled. 
The LSB signifies Microengine 0 and the MSB signifies Microengine 5. 

> dep art . f box_mask = 0x3 f 
Enable all Microengines. 

> dep art . f box_mask = 0x4 
Enable only Microengine 2. 
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A.3.2 


Specify Thread(s) for GOTO 


Used with the deposit and examine commands. A 4-bit value that specifies the thread(s) to which a 
GOTO command applies when used with a label or control store address. When GOTO executes, 
the Transactor runs until the specified thread(s) reach the label or address and ignores any threads 
that are not enabled. There are two formats for this state, either of which can be specified 
independently of the other. The first allows you to specify a Microengine in a context and the 
second one applies to all Microengines in a context. 

Format: { chipname } . f x . art . ctx_mask 

{ chipname } . art . ctx_mask 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


f x 
art 

ctxmask 
Example 1: 
Example 2: 
Example 3: 


The Microengine number, where x indicates the number and valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

Constant that specifies this is a model artifact. 

A four-bit mask that specifies which threads should be enabled. The LSB 
signifies thread 0 and the MSB signifies thread 3. 

> dep f 0 . art . ctx_mask = Oxf 
Enable all threads in Microengine 0. 

> dep f 0 . art . ctx_mask = 0x8 
Enable only thread 2 in Microengine 0. 

> dep art . ctx_mask = 0x8 
Enable thread 2 for all Microengines. 


A.3.3 Report Core Clock Cycles 

Used with the examine command. Indicates the number of StrongARM Core clock cycles 
simulated during the current session. 

Format: sim. core_clk_cycle 

sim Constant that specifies this is a simulator state. 

coreclkcycle 

Specifies that StrongARM Core clock cycles should be displayed. 
Example: 0> ex sim . core_clk_cycle 

sim. core_clk_cycle<31 : 0> : 0x00000000 (0) (model variable) 

Show how many StrongARM Core clock cycles have been simulated 
during the current session. 
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A.3.4 Core Clock Frequency 

Used with the deposit and examine commands. Specifies the StrongARM Core clock frequency in 
MHz. 

Format: sim. core_clk_f req 

sim Constant that specifies this is a simulator state. 

core clk f req Specifies that the StrongARM Core clock frequency is set or displayed. 
Example: 0> ex sim . core_clk_f req 

sim. core_clk_f req<31 : 0> : 0x000000A6 (166) (model variable) 

Show the StrongARM Core clock frequency in MHz. 

A.3.5 Core Clock Period 

Used with the deposit and examine commands. Specifies the number of simulation time units per 
StrongARM Core clock cycle. 

Format: sim. core_clk_period 

sim Constant that specifies this is a simulator state. 

coreclkperiod 

Specifies that the StrongARM Core clock period is set or displayed. 
Example: 0> ex sim . core_clk_period 

sim. core_clk_period<31 : 0> : X00000006 (6) (model variable) 

Show the number of simulation time units per StrongARM Core clock 
cycle. 


A.3.6 Report FBus Clock Cycles 

Used with the examine command. Indicates the number of FBus clock cycles simulated during the 
current session. 

Format: sim. fbus_clk_cycle 

sim Constant that specifies this is a simulator state. 

fbus_clk_cycle 

Specifies that FBus clock cycles should be displayed. 

Example: 0> ex sim . fbus_clk_cycle 

sim. fbus_clk_cycle<31 : 0> : 0x00000000 (0) (model variable) 

Show how many FBus clock cycles have been simulated during the 
current session. 
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A.3.7 FBus Clock Frequency 


Used with the deposit and examine commands. Specifies the FBus clock frequency in MHz. 


Format: 

sim 

fbus_clk_f req 
Example: 


sim. fbus_clk_f req 

Constant that specifies this is a simulator state. 

Specifies that the FBus clock frequency is set or displayed. 


0> ex sim . fbus_clk_f req 
sim. fbus_clk_f req<31 : 0> : 0x00000058 

Show the FBus clock frequency in MHz. 


(88) (model variable) 


A.3.8 


FBus Clock Period 


Used with the deposit and examine commands. Specifies the number of simulation time units per 
FBus clock cycle. 

Format: sim. fbus_clk_period 

sim Constant that specifies this is a simulator state. 

fbus_clk_period 

Specifies that the FBus clock period is set or displayed. 

Example: 0> ex sim . fbus_clk_period 

sim. fbus_clk_period<31 : 0> : 0x00000000 (12) (model variable) 

Show the number of simulation time units per FBus clock cycle. 


A.3.9 


Report PCI Clock Cycles 


Used with the examine command. Indicates the number of PCI clock cycles simulated during the 
current session. 


Format: 

sim 

pci_clk_cycle 


s im . pc i_c 1 k_cy c 1 e 

Constant that specifies this is a simulator state. 

Specifies that PCI clock cycles should be displayed. 


Example: 0> ex sim . pci_clk_cycle 

sim.pci_clk_cycle<31 : 0> : 0x00000000 (0) (model variable) 

Show how many PCI clock cycles have been simulated during the 
current session. 
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PCI Clock Frequency 

Used with the deposit and examine commands. Specifies the PCI clock frequency in MHz. 
Format: sim.pci_clk_f req 

sim Constant that specifies this is a simulator state. 

pci_clk_f req Specifies that the PCI clock frequency is set or displayed. 

Example: 0> ex sim . pci_clk_f req 

sim.pci_clk_f req<31 : 0> : 0x00000058 (88) (model variable) 

Show the PCI clock frequency in MHz. 


PCI Clock Period 

Used with the deposit and examine commands. Specifies the number of simulation time units per 
PCI clock cycle. 

Format: sim.pci_clk_period 

sim Constant that specifies this is a simulator state. 

pci_clk_period 

Specifies that the PCI clock period is set or displayed. 

Example: 0> ex sim . pci_clk_period 

sim.pci_clk_period<31 : 0> : 0x00000000 (12) (model variable) 

Show the number of simulation time units per PCI clock cycle. 
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A.3.12 Execution Order 

Used with the deposit and examine commands. Specifies the order in which watches, callbacks 
and the foreign_model_post_sim routine is called after each Transactor simulation event is 
executed. 

Because watches, callbacks, and foreign_model_post_sim offer the user three different 
mechanisms to actively change state and passively observe state, the execution order of these 
mechanisms is important for correct operation. For example, passive reads (e.g., informational 
debug statements) before an active state change may cause incorrect debugging data to be 
displayed. As another example, incorrect behavior could occur if active state changes are not 
evaluated in the correct order. 

Using the notation W for watches, C for callbacks, and P for foreign_model_post_sim, the legal 
values for execution order are as follows: 


0 

W-C-P 


1 

W-P-C 


2 

C-W-P 


3 

C-P-W 


4 

P-W-C 


5 

P-C-W 


Format: 


sim.post_sim_exec_order 

sim 


Constant that specifies this is a simulator state. 

post_ 

simexec 

order 


Specifies that the execution order is set or displayed. 

Example: 0> ex sim . post_sim_exec_order 

sim.post_sim_exec_order<2 : 0> : 0x0 (0) (model variable) 

Show the execution order of watches, callbacks, and the 
foreign_model_post_sim routine. In this case, the value displayed is 0, 
which represents W-C-P. 


A.3.13 Report Error Count 


Used with the examine command. Indicates the number of errors flagged during the current 
simulation session. 


Format: 


sim.error count 


sim Constant that specifies this is a simulator state. 

error_count Specifies that an error count should be displayed. 


Example: > ex sim . error_count 

sim. error_count<31 : 0> : 0x00000000 (0) (model variable) 

Show how many errors occurred during the current simulation session. 
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Error Handle Mode 

Used with the deposit and examine commands. Sets or displays what action is taken when a 
simulation error occurs. Valid settings are as follows: 

-1 Suppress and ignore the error. 

0 Print the error, but ignore its occurrence. Simulation continues and 
sim.error_count is not incmented. 

1 Print the error, increment sim.error_count, and halt simulation if simulation is in 
progress. 

2 Print the error, increment sim.error_count, and halt simulation and/or any 
command line/script file execution in progress. 

3 Print the error, increment sim.error_count, halt all execution, and exit the 
simulator. 

The default setting is 2. 

Format: sim. error_handle_mode 

sim Constant that specifies this is a simulator state. 

errorhandlemode 

Specifies that error handle mode is set or displayed. 

Example 1: > ex sim . error_handle_mode 

sim. error_handle_mode<31 : 0> : 0x00000002 (2) (model variable) 

Examine the error handle mode. 

Example 2: > dep sim . error_handle_mode = 3 

sim. error_handle_mode [0] <31 : 0> : 0x00000003 (2) (model variable) 

Set the error handle mode to 3. 

Stop Simulation on P1 or P3 

Used with the deposit and examine commands. This state relates to the goto, ubreak, and go fbox/ 
ctx commands. It specifies whether to stop simulation by examining the P1 microword state or the 
P3 microword state. The P3 state is desired in most cases, because a P1 state stop may be a “false” 
one if the P1 microword aborts in P2 or P3. 

Format: sim . goto_and_ubreak_key_on_pl 

sim Constant that specifies this is a simulator state. 

go t o_and_ub r e ak_k ey_on_p 1 

Specifies goto and ubreak key on Pl. 

Example: 0> ex sim . goto_and_ubreak_key_on_pl 

sim. goto_and_ubreak_key_on_pl<31 : 0> : 0x00000000 (0) (model variable) 
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A.3.16 Halt Simulation 


Used with the deposit and examine commands. When set to 1, halts a running simulation at the end 
of the current cycle. Typically used with a watch statement when you want the simulation to stop 
when a specific set of conditions exists. Set to 0 by default. 

Format: sim.halt 


sim 

halt 

Example 1: 
Example 2: 


Constant that specifies this is a simulator state. 

Specifies a halt. 

> ex sim.halt 

sim.halt<0>: 0x0 (0) (model variable) 

Examine the halt state. It is 0 when the simulation is running. 

> dep sim.halt = 1 

sim. halt [0] <0> : 0x1 (1) (model variable) 

Model prematurely stopped by user action. 

Halt the simulation. 


A.3.17 Suppress Comments 


Used with the deposit and examine commands. When set to l, suppresses the display of lines that 
contain only comments. Lines that contain instructions and comments are displayed. Set to 0 by 
default. 


Format: 


sim 


s im . prune_pre f ix_comment s 
Constant that specifies this is a simulator state. 


p r un e_p r e f i x_c ommen t s 

Specifies the supression of prefix comments. 


Example 1: 


Example 2: 


> ex sim . prune_pref ix_comments 

sim.prune_pref ix_comments<0> : 0x0 (0) (model variable) 

Examine the suppress comments state. It is 0 by default. 


> dep sim . prune_pref ix_comments = 
sim.prune_pref ix_comments [0] <0> : 0x1 (1) 

Suppress comments. 


(model variable) 
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Suppress Debug Information 


Used with the deposit and examine commands. When set to 1, suppresses the display of all 
debugging information. Set to 0 by default. 

Format: sim. silent 


sim 
silent 
Example 1: 


Example 2: 


Constant that specifies this is a simulator state. 

Specifies the supression of debug information. 

> ex sim.silent 

sim. silent<0> : 0x0 (0) (model variable) 

Examine the suppress debug information state. It is 0 by default. 

> dep sim.silent = 1 

sim. silent [0] <0> : 0x1 (1) (model variable) 

Suppress debug information. 


Report Simulation Time 


Used with the examine command. Indicates the current simulation time. 


Format: 


sim. time 


sim Constant that specifies this is a simulator state. 

time Specifies simulation time. 


Example: 0> ex sim.time 

sim. time<31 : 0> : 0x00000000 (0) (model variable) 

Show the surrent simulation time. 
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A.3.20 


Specify Debug Verbosity Level 


Used with the deposit and examine commands. For Microengines, this state determines the level of 
verbosity of information that is displayed when you execute the debug command. A value of 0 
(disable information display) through 4 (display information with highest verbosity level) is valid. 
For the FBI, SRAM, and SDRAM, only values of 0 (disable information display) or 1 (enable 
information display) are used. 

Format: { chipname } . unit . art . debug 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

uni t Specifies the unit. Valid names are: 


• fx A Microengine, where x specifies the Microengine 

number. Valid Microengine numbers are 0 through 5 (e.g., fO for 
Microengine 0). You can use the wildcard notation f* with the 
deposit/multi instruction to specify all Microengines. 

• fbi FBI. 

• dc SRAM. 

• sc SDRAM. 


art 
debug 
Example 1: 


Constant that specifies this is a model artifact state. 

Specifies debug verbosity. 

> dep f 0 . art . debug_p0 = l//view stage 0 

> dep fO.art.debug = 1 

> debug 

= = = = P0 fbox stage (ustore lookup) for fO. in ctx: 
0 at fbox cycle 5==== 
ustore addr = 4 ==> A00A3038 

sram_bi [read, $val, val_ptr, 0, word_cnt_l] , 
defer[l], ctx_swap ; $val = val 

View only execution stage 0 (refer to the Specify Reported Execution 
Stages state for more information on execution stages). 


Example 2: 


> dep f 0 . art . debug_p4 = 1 // view only pipeline stage 4 

f 0 . art . debug_p4 [0] <0> : 0x1 (1) (model variable) 

> debug 

ctx_0 : saved_pc : 6; signals--> SELF ; wake_enable- - > SELF 

ctx_l : saved_pc : 1; signals--> SELF ; wake_enable- - > 

ctx_2 : saved_pc : 0; signals--> SELF ; wake_enable- - > SELF 

ctx_3 : saved_pc : 0; signals--> SELF ; wake_enable- - > SELF 

ping ref (output) : READ ; addr = 00000001; fbox = 0 ctx = 0 

burst_cnt = 1 (issued at fbox cycle = 7; uPC = 3) 
pong ref (input ) : READ ; addr = 00000002; fbox = 0 ctx = 0 

burst_cnt = 1 (issued at fbox cycle = 8; uPC = 4) 

====P4 fbox stage (write result) for fO. in ctx: 0 at fbox 
cycle 9==== 
uword addr = 4 

sram_bi [read, $val, val_ptr, 0, word_cnt_l] , 
defer[l], ctx_swap ; $val = val 


W_BUS: 00000002 

View only execution stage 4 (refer to the Specify Reported Execution 
Stages state for more information on execution stages). 
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Specify Reported Execution Stages 


Used with the deposit and examine commands. Determines which micropipeline execution stages 
are displayed when you execute the debug command. When the fx.art.debug state is enabled to 
display execution pipeline stage information, this state disables the display of the specified 
Microengine execution pipeline stage information. For example, when fO.art.debug is set to 4, the 
Microengine execution pipeline stage information for each stage will be displayed. If 
f0.art.debug_p3 is set to 0 then only stages 0,1,2, and 4 will be displayed. Depositing a value of 0 
disables the display. 

Format: { chipname } . f x . art . debug_px 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


f x 


art 

debugpx 


Example: 


The Microengine number, where x specifies the number. Valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). You 
can use the wildcard notation f* with the deposit/multi instruction to 
specify all Microengines. 

Constant that specifies this is a model artifact state. 

Specifies one of the five execution stages. Valid names are: 


debug_p0 

debug_pl 

debug_p2 

debug_p3 

debug_p4 


Execution stage 0. 
Execution stage 1 . 
Execution stage 2. 
Execution stage 3. 
Execution stage 4. 


Display all execution stages when the debug command is executed. 
Assume a low level of verbosity (refer to the Specify Debug Verbosity 
Level state for more information on the verbosity level). 

> dep f 0 . art . debug_p0 = l//view stage 0 

> dep f 0 . art . debug_pl = l//view stage 1 

> dep f 0 . art . debug_p2 = l//view stage 2 

> dep f 0 . art . debug_p3 = l//view stage 3 

> dep f 0 . art . debug_p4 = l//view stage 4 

> debug 

====P4 fbox stage (write result) for fO. in ctx: 0 at fbox cycle 5==== 
uword addr = 0 

. operand_synonym no_of_links 0x3 
start# : 

ld_f ield_b [cur_ptr , 1111, headptr, 0] ;cur_head = headptr 


W_BUS: 00000001 

operand write: GPR_A [0] =00000001 

====P 3 fbox stage (ALU/shif ter) for fO. in ctx: 0 at fbox cycle 5==== 
uword addr = 1 


immed [loop_no, no_of_links] ; loop = the number of links 

A operand: 00000000; pre-shift B operand: 00000003; B operand: 
00000003 


shifter op : left shift 0; ALU op : ALU_OP_B; ALU result : 00000003; 
old_ccs : ! =0 : >=0 : no_carry 

= = = = P2 fbox stage (operand lookup) for fO. in ctx: 0 at fbox cycle 5 = = = 
uword addr = 2 
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loop_add# : 

alu_shf_ri [val_ptr , cur_ptr , +, 1, 0] ;val_ptr = cur_ptr +1 
A operand: 00000001 (selected from writeback bypassed data) ; 

B operand: 00000001 (selected from immed data) ; 

= = = = P1 fbox stage (initial decode) for fO. in ctx: 0 at fbox cycle 5 = = = 
uword addr = 3 

sram_bi [read, $next, cur_ptr, 0, word_cnt_l] ; $next = next 
====P0 fbox stage (ustore lookup) for fO. in ctx: 0 at fbox cycle 5=== 
ustore addr = 4 ==> A00A3038 

sram_bi [read, $val, val_ptr, 0, word_cnt_l] , 
defer[l], ctx_swap ; $val = valdep art.ctx_mask = 0x8 


A.3.22 Chip Version 


Used with the deposit and examine commands. These states specify the chip version for all chips to 
be instantiated. 


Format: 


param 


param . ma j or_stepping 
param . minor_stepping 

Constant that specifies this is a simulation parameter state. 


ma j or_s tepping Specifies the major stepping where 0, 1, 2,... represent steppings A, B, 
C,... 

minor_stepping Specifies the minor stepping, e.g., 0, 1, .... 


Note: A deposit to these states should only be done prior to instantiating any chips. Changing these 

values after a chip has been instantiated will have unpredictable results. 


Example: 


f box : 0 > dep param.major_stepping = 2 

param . maj or_stepping [0] <31 : 0> : 0x00000002 (2) (model variable) 


f box : 0 > dep param.minor_stepping = 0 

param.minor_stepping [0] <31 : 0> : 0x00000000 (0) (model variable) 


Set stepping to C0. 
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Suppressing Outstanding Signal Errors or Warnings 

Used with the deposit and examine commands. These states control the reporting of outstanding 
signal errors or warnings. 

Format: param. suppress_outstanding_sig_err 

param . suppress_out standing_sig_warn 

param Constant that specifies this is a simulation parameter state. 

suppress_outs tanding_sig_err Specifies that the error reported when a signal 

is received when the same signal is already outstanding should be 
suppressed. A warning will be reported unless it too is suppressed 

suppress_outstanding_sig_warning Specifies that the waming reported when a 
signal is received when the same signal is already outstanding should be 
suppressed. This state has no effect if the error is not suppressed. 

Use this option with caution, since in most cases, the error indicates a programming error 

Example: f box : 0 > dep param. suppress_outstanding_sig_err = 1 

param. suppress_outstanding_sig_err [0] <0> : 0x1 (1) (model variable) 

f box : 0 > dep param. suppress_outstanding_sig_warn = 1 

param. suppress_outstanding_sig_warn [0] <0> : 0x1 (1) (model variable) 


Suppress both errors and wamings. 
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A.4 Statistics States 


A.4.1 


Compute Cycles 


Used with the examine command. Displays the efficiency of Microengine compute cycles. There 
are three types of cycles: non-aborted (work is performed), aborted (no work is performed but the 
Microengine is still executing), and stalled (no work is performed because the Microengine stalls). 

Format: { chipname } . f x . stat . compute_cycles 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


fx 


stat 


The Microengine number, where x indicates the number and valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

Constant that specifies this is a model statistic. 


computecycles 

Specifies that the statistic type is compute cycles. 

Example: > ex f0.stat.compute_cycles 

f 0 . stat . compute_cycles : statistics collector : 

"Breakdown of compute cycles for fO" 

samples = 24; min = 0; ave = 4; max = 9; data units = cycles 


ctx 

0 

non-aborted cycles : 

6 

(25%) 

************ 

ctx 

0 

aborted cycles : 

1 

(4%) 

* * 

ctx 

0 

stalled cycles : 

0 

(0%) 


ctx 

1 

non-aborted cycles : 

6 

(25%) 

************ 

ctx 

1 

aborted cycles : 

0 

(0%) 


ctx 

1 

stalled cycles : 

0 

(0%) 


ctx 

2 

non-aborted cycles : 

6 

(25%) 

************ 

ctx 

2 

aborted cycles : 

0 

(0%) 


ctx 

2 

stalled cycles : 

0 

(0%) 


ctx 

3 

non-aborted cycles : 

5 

(21%) 

********** 

ctx 

3 

aborted cycles : 

0 

(0%) 


ctx 

3 

stalled cycles : 

0 

(0%) 


no ctx active cycles : 

0 

(0%) 
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SDRAM Read Latency 

Used with the examine command. Displays the latency distribution for SDRAM references that 
retum data to a Microengine. 

Format: { chipname } . f x . stat . sdram_read_latency 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

f x The Microengine number, where x indicates the number and valid 

Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

stat Constant that specifies this is a model statistic. 

sdram_read_latency 

Specifies that the statistic type is sdram_read_latency. 

Example: > ex f 0 . stat . sdram_read_latency 

f 0 . stat . sdram_read_latency istatistics collector : 


SRAM Read Latency 


Used with the examine command. Displays the latency distribution for SRAM references that 
retum data to a Microengine. 

Format: { chipname } . f x . stat . sram_read_latency 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

f x The Microengine number, where x indicates the number and valid 

Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

stat Constant that specifies this is a model statistic. 


s r am_r ead_l a t ency 

Specifies that the statistic type is sram_read_latency. 


Example: 


> ex f 0 . stat . sram_read_latency 

f 0 . stat . sram_read_latency : statistics collector: " latency 

distribution for SRAM non-read_lock refs returning data to 


f 0" 


samples = 10; 

min = 

17 ; 

ave = 

cycles 

sample distrib 

1 4| 

5| 

i| 

percent 

1 40% | 

50% | 

10% 1 

cumul percent 

1 40% | 

90% | 100% | 

cycles 

1 17 

1 18 | 

24 | 


1 8 ; max 


24; data units 
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A.4.4 SRAM Read Lock Latency 

Used with the examine command. Displays the latency distribution for SRAM read lock references 
that return data to a Microengine. 

Format: { chipname } . f x . stat . sram_read_lk_latency 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

f x The Microengine number, where x indicates the number and valid 

Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

stat Constant that specifies this is a model statistic. 

sram_read_lk_latency 

Specifies that the statistic type is sram_read_lk_latency. 

Example: > ex f 0 . stat . sram_read_lk_latency 


A.4.5 Thread PC During Idle Cycle 

Used with the examine command. For a given Microengine, displays a thread’s microstore address 
when no threads are actively running. 

Format: { chipname } . f x . stat . threadx_pc_during_idle_cycles 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

f x The Microengine number, where x indicates the number and valid 

Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

stat Constant that specifies this is a model statistic. 

threadx_pc_during_idle_cycles 

Specifies the thread. Valid names are: 

• threadO_pc_during_idle_cycles Thread 0. 

• threadl_pc_during_idle_cycles Thread 1. 

• thread2_pc_during_idle_cycles Thread 2. 

• thread3_pc_during_idle_cycles Thread 3. 

Example: > ex f 0 . stat . threadO_pc_during_idle_cycles 
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Thread Latency 


Used with the examine command. Displays information on thread latency, defined as the time 
between the occurrences of the following two states: {chipname}.fx.art.thread_start_addr and 
{ chipname } .fx.art.thread_stop_addr. 

Format: { chipname } . f x . stat . thread_latency 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


f x The Microengine number, where x indicates the number and valid 

Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

stat Constant that specifies this is a model statistic. 

thread_latency 


Example: 


Specifies thread latency. 

> ex f 0 . stat . thread_latency 


Thread Latency Start and Stop Addresses 


Used with the deposit and examine commands. These two states define the beginning and end 
points of an interval in which the thread latency is measured (see the state definition for 
fx . s tat . thread_latency ) . 

Format: { chipname } . f x . art . thread_latency_start_addr 

{ chipname } . f x . art . thread_latency_stop_addr 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


f x 


art 


The Microengine number, where x indicates the number and valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

Constant that specifies this is a model artifact state. 


thread_latency_start_addr 

An address in the specified Microengine control store that indicates the 
starting point for measuring the thread latency. 


thread_latency_stop_addr 

An address in the specified Microengine control store that indicates the 
end point for measuring the thread latency. 

Example: > f 0 . art . thread_start_addr = uaddr (f 0 . ctl . ustore , "labell#"); 

> f 0 . art . thread_stop_addr = uaddr ( f 0 . ctl . ustore , "label2#"); 

> goto /s label2# 

> ex f 0 . stat . thread_latency 

Set a beginning point at labell# and an end point at label2#. Go to the 
end point and display the thread latency. 
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A.4.8 Time Slice 

Used with the examine command. Displays time slice information for a specified thread. A time 
slice starts when a thread starts and ends when the thread is put to sleep. 

Format: { chipname } . f x . stat . time_slice_threadx 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


f X 

The Microengine number, where x indicates the number and valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

stat 

Constant that specifies this is a model statistic. 

timeslice 

threadx 

Specifies the time slice thread. Valid 

names are: 


• time slice threadO 

Thread 0. 


• time slice threadl 

Thread 1. 


• time slice thread2 

Thread 2. 


• time_slice_thread3 

Thread 3. 

Example: 

> ex f 0 . stat . time_slice_threadO 


A.4.9 


Time Slice Thread Idle 


Used with the examine command. Displays the amount of time during which a specified thread is 
idle during a time slice. A time slice starts when a thread starts and ends when the thread is put to 
sleep. 


Format: 

chipname 

fx 

stat 


{ chipname } . fx . stat . time_slice_threadx_idle 

An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

The Microengine number, where x indicates the number and valid 
Microengine numbers are 0 through 5 (e.g., fO for Microengine 0). 

Constant that specifies this is a model statistic. 


time_slice_threadx_idle 

Specifies the time slice idle thread. Valid names are: 

Thread 0. 


• time_slice_threadO_idle 

• time_slice_threadl_idle 

• time_slice_thread2_idle 

• time slice thread3 idle 


Thread 1. 
Thread 2. 
Thread 3. 


Example: 


> ex fO.stat.time slice threadO idle 
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SDRAM Bandwidth 


Used with the examine command. Displays bandwidth distribution statistics for SDRAM. 


Format: 

chipname 


{ chipname } . dc . stat . bandwidth 

An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 


dc 

stat 

bandwidth 


Constant that specifies this state refers to SDRAM. 
Constant that specifies this is a model statistic. 
Specifies that this statistic relates to bandwidth data. 


Example: 


> ex dc . stat . bandwidth 
dc . stat .bandwidth: statistics 
Distribution for dc" 
samples = 20; min = 0; ave 


sdram cycles 

read cycles : 8 
write cycles : 0 
rd->wr dead cycles : 0 
idle cycles : 12 


collector: "SDRAM Bandwidth 

= 1; max = 3; data units = 

(40%) ************* 

( 0 %) 

( 0 %) 

(60%) ********************* 


SDRAM Even Bank Queue Fullness 


Used with the examine command. Displays fullness statistics for the SDRAM even bank queue. 
Format: { chipname } . dc . stat . even_bank_queue_f ullness 

chipname 


dc 

stat 


An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this state refers to SDRAM. 

Constant that specifies this is a model statistic. 


even_bank_queue_fullness 

Specifies that this statistic relates to even bank queue fullness. 

Example: > ex dc.stat .even_bank_queue_fullness 

dc . stat . even_bank_queue_fullness : statistics collector : 
"SDRAM Even Bank Queue Fullness Statistics for dc; queue size 
= 16 " 

samples = 20; min = 0; ave = 0; max = 0; data units = 

queue entries 

sample distrib | 20 | 

percent | 1 0 0 % | 

cumul percent | 1 0 0 % | 

queue entries | 0 | 
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A.4.12 SDRAM Odd Bank Queue Fullness 


Used with the examine command. Displays fullness statistics for the SDRAM odd bank queue. 
Format: { chipname } . dc . stat . odd_bank_queue_f ullness 

chipname 


dc 

stat 


An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this state refers to SDRAM. 

Constant that specifies this is a model statistic. 


odd_bank_queue_fullness 

Specifies that this statistic relates to odd bank queue fullness. 

Example: > ex dc.stat .odd_bank_queue_fullness 

dc . stat . odd_bank_queue_fullness : statistics collector : 

" SDRAM Odd Bank Queue Fullness Statistics for dc; queue size 
= 16 " 

samples = 20; min = 0; ave = 0; max = 0; data units = 

queue entries 

sample distrib | 20 | 

percent | 1 0 0 % | 

cumul percent | 1 0 0 % | 

queue entries | 0 | 


A.4.13 SDRAM Order Queue Fullness 


Used with the examine command. Displays fullness statistics for the SDRAM order queue. 
Format: { chipname } . dc . stat . order_queue_f ullness 

chipname 


dc 

stat 


An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this state refers to SDRAM. 

Constant that specifies this is a model statistic. 


orderqueuefullness 

Specifies that this statistic relates to order queue fullness. 

Example: > ex dc.stat .order_queue_fullness 

dc . stat . order_queue_fullness : statistics collector: "SDRAM 

Order Queue Fullness Statistics for dc; queue size = 16" 

samples = 20; min = 0; ave = 0; max = 0; data units = 

queue entries 

sample distrib | 20 | 

percent | 1 0 0 % | 

cumul percent | 1 0 0 % | 

queue entries | 0 | 
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SDRAM Priority Queue Fullness 


Used with the examine command. Displays fullness statistics for the SDRAM priority queue. 
Format: { chipname } . dc . stat . priority_queue_f ullness 

chipname 


dc 

stat 


An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this state refers to SDRAM. 

Constant that specifies this is a model statistic. 


priority_queue_fullness 

Specifies that this statistic relates to priority queue fullness. 

Example: > ex dc.stat .priority_queue_fullness 

dc . stat .priority_queue_fullness : statistics collector : 

" SDRAM Priority Queue Fullness Statistics for dc; queue size 
= 16 " 

samples = 20; min = 0; ave = 0; max = 0; data units = 

queue entries 

sample distrib | 20 | 

percent | 1 0 0 % | 

cumul percent | 1 0 0 % | 

queue entries | 0 | 


SRAM Bandwidth 


Used with the examine command. Displays bandwidth distribution statistics for SRAM. 


Format: 

chipname 


{ chipname } . sc . stat . bandwidth 

An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 


sc 

stat 

bandwidth 


Constant that specifies this state refers to SRAM. 
Constant that specifies this is a model statistic. 
Specifies that this statistic relates to bandwidth data. 


Example: 


> ex sc . stat .bandwidth 

sc . stat .bandwidth: statistics 

Distribution for sc" 


samples = 20; min = 0; ave = 

cycles 

read cycles : 8 

write cycles : 0 

rd->wr dead cycles : 0 

idle cycles : 12 


collector: "SRAM Bandwidth 

1; max = 3; data units = sram 

(40%) ************** 

( 0 %) 

( 0 %) 

(60%) *********************** 
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A.4.16 SRAM Order Queue Fullness 

Used with the examine command. Displays fullness statistics for the SRAM order queue. 

Format: { chipname } . sc . stat . order_queue_f ullness 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 

sc Constant that specifies this state refers to SRAM. 

stat Constant that specifies this is a model statistic. 

order_queue_fullness 

Specifies that this statistic relates to order queue fullness. 

Example: > ex sc.stat .order_queue_fullness 

sc . stat . order_queue_fullness : statistics collector: "SRAM 

Order Queue Fullness Statistics for sc; queue size = 16" 

samples = 20; min = 0; ave = 0; max = 0; data units = 

queue entries 

sample distrib | 20 | 

percent | 1 0 0 % | 

cumul percent | 1 0 0 % | 

queue entries | 0 | 


A.4.17 SRAM Priority Queue Fullness 


Used with the examine command. Displays fullness statistics for the SRAM priority queue. 

F ormat: { chipname } .sc.stat.priority_queue_fullness 

chipname An optional chip name that is meaningful only if the chip has been 

instantiated with a name. 


sc Constant that specifies this state refers to SRAM. 

stat Constant that specifies this is a model statistic. 


priority_queue_fullness 

Specifies that this statistic relates to priority queue fullness. 

Example: > ex sc.stat .priority_queue_fullness 

sc . stat .priority_queue_fullness : statistics collector: "SRAM 

Priority Queue Fullness Statistics for sc; queue size = 16" 

samples = 20; min = 0; ave = 0; max = 0; data units = 

queue entries 

sample distrib | 20 | 

percent | 1 0 0 % | 

cumul percent | 1 0 0 % | 

queue entries | 0 | 
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SRAM Read Lock Queue Fullness 


Used with the examine command. Displays fullness statistics for the SRAM read lock queue. 
Format: { chipname } . sc . stat . rd_lk_queue_f ullness 

chipname 


sc 

stat 


An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this state refers to SRAM. 

Constant that specifies this is a model statistic. 


rd_lk_queue_fullness 

Specifies that this statistic relates to read lock queue fullness. 

Example: > ex sc.stat .rd_lk_queue_fullness 

sc . stat . rd_lk_queue_fullness : statistics collector: "SRAM 

Read Lock Queue Fullness Statistics for sc; queue size = 16" 

samples = 20; min = 0; ave = 0; max = 0; data units = 

queue entries 

sample distrib | 20 | 

percent | 1 0 0 % | 

cumul percent | 1 0 0 % | 

queue entries | 0 | 


SRAM Read Queue Fullness 


Used with the examine command. Displays fullness statistics for the SRAM read queue 
Format: { chipname } . sc . stat . read_queue_f ullness 

chipname 


sc 

stat 


An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this state refers to SRAM. 

Constant that specifies this is a model statistic. 


read_queue_fullness 

Specifies that this statistic relates to read queue fullness. 

Example: > ex sc.stat .read_queue_fullness 

sc . stat . read_queue_fullness : statistics collector: "SRAM 

Read Queue Fullness Statistics for sc; queue size = 16" 

samples = 20; min = 0; ave = 0; max = 0; data units = 

queue entries 

sample distrib | 20 | 

percent | 1 0 0 % | 

cumul percent | 1 0 0 % | 

queue entries | 0 | 
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A.4.20 SRAM State Machine Distribution 


Used with the examine command. Displays state machine distribution statistics for SRAM. 
Format: { chipname } . sc . stat . state_machine_dist 

chipname 


sc 

stat 


An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this state refers to SRAM. 

Constant that specifies this is a model statistic. 


state_machine_dist 

Specifies that this statistic relates to state machine distribution. 

Example: > ex sc.stat . state_machine_dist 

sc . stat . state_machine_dist : statistics collector: "SRAM 

State Machine Distribution Statistics for sc; queue size = 16" 

samples = 20; min = 0; ave = 0; max = 0; data units = 

queue entries 

sample distrib | 20 | 

percent | 1 0 0 % | 

cumul percent | 1 0 0 % | 

queue entries | 0 | 


A.4.21 Command Bus Bandwidth 


Used with the examine command. Displays bandwidth distribution statistics for the command bus. 
Format: { chipname } . sc . stat . cmd_bus_bandwidth 

chipname 


sc 

stat 


An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this state refers to SRAM. 

Constant that specifies this is a model statistic. 


cmdbusbandwidth 

Specifies that this statistic relates to the command bus bandwidth. 

Example: > ex sc.stat . cmd_bus_bandwidth 

stat . cmd_bus_bandwidth : statistics collector: "Reference 

Packet Bandwidth Distribution for chip "" " 


samples = 60; min 
cycles 

= 0; 

ave = 0; max = 2; data units = fbox 

no refs: 

45 

(75%) ***************************** 

SDRAM refs: 

0 

(0%) 

SRAM refs: 

15 

(25%) ************ 

SRAM_CSR refs: 

0 

(0%) 

PCI ref s : 

0 

(0%) 

FBI refs: 

0 

(0%) 

Scratch-Pad refs: 

0 

(0%) 
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SBUS Pull Bus Bandwidth 


Used with the examine command. Displays bandwidth distribution statistics for the SBUS pull bus. 
Format: { chipname } . stat . sbus_pull_bandwidth 

chipname 


stat 


An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this is a model statistic. 


sbus_pull_bandwidth 

Specifies that this statistic relates to the SBUS pull bus bandwidth. 


Example: 


> ex stat . sbus_pull_bandwidth 

stat . sbus_pull_bandwidth : statistics collector : 
pull bus bandwidth distribution for chip "" " 
samples = 60; min = 15; ave = 23; max = 31; 
= fbox cycles 


"SRAM data 


data units 


SRAM <- Fbox 0 data: 

0 

(0% 

SRAM <- Fbox 1 data: 

0 

(0% 

SRAM <- Fbox 2 data: 

0 

(0% 

SRAM <- Fbox 3 data: 

0 

(0% 

SRAM <- Fbox 4 data: 

0 

(0% 

SRAM <- Fbox 5 data: 

0 

(0% 

SRAM <- FBI data: 

0 

(0% 

SRAM <- Fbox 0 CSR data: 

0 

(0% 

SRAM <- Fbox 1 CSR data: 

0 

(0% 

SRAM <- Fbox 2 CSR data: 

0 

(0% 

SRAM <- Fbox 3 CSR data: 

0 

(0% 

SRAM <- Fbox 4 CSR data: 

0 

(0% 

SRAM <- Fbox 5 CSR data: 

0 

(0% 

SRAM <- no xfer: 

30 

(50% 

FBI <- Fbox 0 data: 

0 

(0% 

FBI <- Fbox 1 data: 

0 

(0% 

FBI <- Fbox 2 data: 

0 

(0% 

FBI <- Fbox 3 data: 

0 

(0% 

FBI <- Fbox 4 data: 

0 

(0% 

FBI <- Fbox 5 data: 

0 

(0% 

FBI <- FBI data : 

0 

(0% 

FBI <- Fbox 0 CSR data: 

0 

(0% 

FBI <- Fbox 1 CSR data: 

0 

(0% 

FBI <- Fbox 2 CSR data: 

0 

(0% 

FBI <- Fbox 3 CSR data: 

0 

(0% 

FBI <- Fbox 4 CSR data: 

0 

(0% 

FBI <- Fbox 5 CSR data: 

0 

(0% 

FBI <- no xfer: 

30 

(50% 


*********************** 


*********************** 
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A.4.23 SBUS Push Bus Bandwidth 


Used with the examine command. Displays bandwidth distribution statistics for the SBUS push 
bus. 


Format: 

chipname 

stat 


{ chipname } . stat . sbus_push_bandwidth 

An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this is a model statistic. 


sbus_push_bandwidth 

Specifies that this statistic relates to the SBUS push bus bandwidth. 


Example: 


> ex stat . sbus_push_bandwidth 

stat . sbus_push_bandwidth : statistics collector : 
push bus bandwidth distribution for chip "" " 
samples = 60; min = 15; ave = 23; max = 31; 
= fbox cycles 


"SRAM data 


data units 


SRAM <- Fbox 0 data: 

0 

(0% 

SRAM <- Fbox 1 data: 

0 

(0% 

SRAM <- Fbox 2 data: 

0 

(0% 

SRAM <- Fbox 3 data: 

0 

(0% 

SRAM <- Fbox 4 data: 

0 

(0% 

SRAM <- Fbox 5 data: 

0 

(0% 

SRAM <- FBI data: 

0 

(0% 

SRAM <- Fbox 0 CSR data: 

0 

(0% 

SRAM <- Fbox 1 CSR data: 

0 

(0% 

SRAM <- Fbox 2 CSR data: 

0 

(0% 

SRAM <- Fbox 3 CSR data: 

0 

(0% 

SRAM <- Fbox 4 CSR data: 

0 

(0% 

SRAM <- Fbox 5 CSR data: 

0 

(0% 

SRAM <- no xfer: 

30 

(50% 

FBI <- Fbox 0 data: 

0 

(0% 

FBI <- Fbox 1 data: 

0 

(0% 

FBI <- Fbox 2 data: 

0 

(0% 

FBI <- Fbox 3 data: 

0 

(0% 

FBI <- Fbox 4 data: 

0 

(0% 

FBI <- Fbox 5 data: 

0 

(0% 

FBI <- FBI data : 

0 

(0% 

FBI <- Fbox 0 CSR data: 

0 

(0% 

FBI <- Fbox 1 CSR data: 

0 

(0% 

FBI <- Fbox 2 CSR data: 

0 

(0% 

FBI <- Fbox 3 CSR data: 

0 

(0% 

FBI <- Fbox 4 CSR data: 

0 

(0% 

FBI <- Fbox 5 CSR data: 

0 

(0% 

FBI <- no xfer: 

30 

(50% 


*********************** 


*********************** 
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SDRAM Pull Bus Bandwidth 


Used with the examine command. Displays bandwidth distribution statistics for the SDRAM pull 
bus. 


Format: 

chipname 

stat 


{ chipname } . stat . sdram_pull_bandwidth 

An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this is a model statistic. 


sdrampullbandwidth 

Specifies that this statistic relates to the SDRAM pull bus bandwidth. 


Example: 


> ex stat . sdram_pull_bandwidth 

stat . sdram_pull_data_bandwidth : statistics collector: "SDRAM 

pull data bus bandwidth distribution for chip "" " 
samples = 60; min = 7; ave = 7; max = 7; 


data units 


fbox cycles 
SDRAM < - Fbox 

0 

data 

0 

(0%) 

SDRAM 

< - 

Fbox 

1 

data 

0 

(0%) 

SDRAM 

< - 

Fbox 

2 

data 

0 

(0%) 

SDRAM 

< - 

Fbox 

3 

data 

0 

(0%) 

SDRAM 

< - 

Fbox 

4 

data 

0 

(0%) 

SDRAM 

< - 

Fbox 

5 

data 

0 

(0%) 

SDRAM 

< - 

R- f if o 

data 

0 

(0%) 

SDRAM 

< - 

no xfer: 

60 

(100%) 


( 100 %) ************************* 
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A.4.25 SDRAM Push Bus Bandwidth 


Used with the examine command. Displays bandwidth distribution statistics for the SDRAM push 
bus. 


Format: 

chipname 

stat 


{ chipname } . stat . sdram_push_bandwidth 

An optional chip name that is meaningful only if the chip has been 
instantiated with a name. 

Constant that specifies this is a model statistic. 


sdrampullbandwidth 

Specifies that this statistic relates to the SDRAM push bus bandwidth. 


Example: 


> ex stat . sdram_push_bandwidth 

stat . sdram_push_data_bandwidth : statistics collector: "SDRAM 

push data bus bandwidth distribution for chip "" " 
samples = 60; min = 7; ave = 7; max = 7; 


data units 


fbox cycles 
SDRAM < - Fbox 

0 

data 

0 

(0%) 

SDRAM 

< - 

Fbox 

1 

data 

0 

(0%) 

SDRAM 

< - 

Fbox 

2 

data 

0 

(0%) 

SDRAM 

< - 

Fbox 

3 

data 

0 

(0%) 

SDRAM 

< - 

Fbox 

4 

data 

0 

(0%) 

SDRAM 

< - 

Fbox 

5 

data 

0 

(0%) 

SDRAM 

< - 

R- f if o 

data 

0 

(0%) 

SDRAM 

< - 

no xfer: 

60 

(100%) 


( 100 %) ************************* 
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Developer Workbench Shortcuts B 


B.1 Introduction 

In the Developer Workbench there are at least three ways to initiate an action: 

• A menu command 

• A keyboard shortcut 

• A toolbar button 

The following tables summarize most these tools. 

Table B-3. Developer Workbench Shortcuts — Files 


Button 

Keyboard 

Menu 

Action 

Reference 


_dJ 


CTRL+N 

File, New 

Create new file. 

Section 2.7.1 . 


& 


CTRL+O 

File, Open 

Open a file. 

Section 2.7.2. 


H 


CTRL+S 

File, Save 

Save a file. 

Section 2.7.4. 


ALT+F+A 

File, Save As 

Save copy of file. 

Section 2.7.5. 


S 


ALT+F+L 

File, Save All 

Save all open files. 

Section 2.7.6. 


ALT+F+U 

File, Print Setup 

Set up the printer 
properties. 

Section 2.7.8. 1 . 


ALT+F+I 

File, Print Preview 

View the file to be 
printed. 

Section 2. 7. 8. 2. 


m 


CTRL+P 

File, Print 

Print file in active 
window. 

Section 2. 7. 8. 3. 


ALT+F+F 

File, Recent Files 

Select from the four most 
recently opened files. 

Section 2.7.2. 


ALT+F+C 

File, Close, or 
Wlndow, Close 

Close the active window. 

Section 2.7.3. 
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Table B-4. Developer Workbench Shortcuts — Projects 


Button 

Keyboard 

Menu 

Action 

Reference 


ALT+F+W 

File, New Project 

Create a new project. 

Section 2.4.1 . 


ALT+F+R 

File, Open Project 

Open a project. 

Section 2.4.2. 


ALT+F+V 

File, Save Project 

Save project. 

Section 2.4.3 


ALT+F+E 

File, Close Project 

Close a project. 

Section 2.4.4. 


ALT+P+I 

Project, Insert 
Assembler Source 
Files 

Insert Assembler source 
files into a project. 

Section 2.7.9. 1 . 



Project, Insert 
Compiler Source Files 

Insert Compiler source 
files into a project. 

Section 2.7.9. 1 . 


ALT+P+S 

Project, Insert Script 
Files 

Insert script files into a 
project. 

Section 2.7.9. 1 . 


ALT+P+U 

Project, Update 
Dependencies 

Update project 
dependencies. 

Section 2.8.1 . 


ALT+P+C 

Project, System 
Configuration 

Specify system 
configuration. 

Section 2.5. 


Table B-5. Developer Workbench Shortcuts — Edit (Sheet 1 of 2) 


Button 

Keyboard 

Menu 

Action 

Reference 


O 


CTRL+Z 

Edit, Undo 

Undo. 

Section 2.7.10. 

i 

M 

i 

CTRL+Y 

Edit, Redo 

Redo. 

Section 2.7.10. 


E 

i 

CTRL+X 

Edit, Cut 

Cut. 

Section 2.7.10. 

i 


i 

CTRL+C 

Edit, Copy 

Copy selected text. 

Section 2.7.10. 


© 


CTRL+V 

Edit, Paste 

Paste. 

Section 2.7.10. 


>7 


DELETE 

DELETE key 

Delete. 

Section 2.7.10. 


CTRL+A 

Edit, Select All 

Select all text in the file. 

Section 2.7.10. 




CTRL+F 

Edit, Find 

Find text in a text file. 

Section 2.7.10. 
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Table B-5. Developer Workbench Shortcuts — Edit (Sheet 2 of 2) 


Button 

Keyboard 

Menu 

Action 

Reference 


i£? 


CTRL+SHIFT+F 


Find next. 

Section 2.7.10. 


% 


ALT+E+I 

Edit, Find in Files 

Find in text files. 

Section 2.7.12. 


CTRL+H 

Edit, Replace 

In the Replace dialog 
box, replace the items 
currently selected in the 
file with the text in the 
Replace with box. 

Section 2.7.10. 



Table B-6. Developer Workbench Shortcuts — Bookmarks 


Button 

Keyboard 

Menu 

Action 

Reference 

i 

3 


CTRL+F2 

Edit, Bookmark, 
Insert/Remove 

Insert/Remove 

bookmark. 

Section 2.7.11 . 




F2 

Edit, Bookmark, Go 
To Next 

Go to the next bookmark. 

Section 2.7.11 . 


% 


SHIFT+F2 

Edit, Bookmark, Go 
To Previous 

Go to previous 
bookmark. 

Section 2.7.11 . 


% 


CTRL+SHIFT+F2 

Edit, Bookmark, Clear 
All 

Clear all bookmarks. 

Section 2.7.11 . 


Table B-7. Developer Workbench Shortcuts — Breakpoints 


Button 

Keyboard 

Menu 

Action 

Reference 


* 


F9 

Debug, Breakpoint, 
Insert/Remove 

Insert/Remove 

breakpoint. 

Section 2.11 .10.3, 
Section 2.11 .17.2. 


SET 


CTRL+F9 

Debug, Breakpoint, 
Enable/Disable 

Toggle enable/disable. 

Section 2.11 .10.4. 

Idtol 

ALT+D+B+D 

Debug, Breakpoint, 
Disable All 

Disable all breakpoints in 
active document. 

Section 2.11 .10.4. 

i 

[H| 

ALT+D+B+A 

Debug, Breakpoint, 
Enable All 

Enable all breakpoints in 
the active document. 

Section 2.11 .10.4. 


4b 


ALT+D+B+R 

Debug, Breakpoint, 
Remove All 

Remove all breakpoints 
from the active 
document. 

Section 2.11 .10.3. 
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Table B-8. Developer Workbench Shortcuts — Builds 


Button 

Keyboard 

Menu 

Action 

Reference 




CTRL+F7 

Build, Assemble 

Invoke the Assembler. 

Section 2.8.3. 




CTRL+SHIFT+F7 

Build, Compile 

Compile. 

Section 2.9.3. 


illi 


F7 

Build, Build 

Link. 

Section 2.10. 




ALT+F7 

Build, Rebuild 

Rebuild. 

Section 2.10. 


Table B-9. Developer Workbench Shortcuts — Debug 


Button 

Keyboard 

Menu 

Action 

Reference 




F12 

Debug, Start 
Debugging 

Start debugging. 

Section 2.11 .1 . 




CTRL+F12 

Debug, Stop 
Debugging 

Stop debugging. 

Section 2.11 .1 . 




F4 


Go to next error/tag. 

Section 2.7.11 , 
Section 2.7.12, 
Section 2.8.4, 
Section 2.9.4. 




SHIFT+F4 


Go to previous error/tag. 

Section 2.7.11 , 
Section 2.8.4, 
Section 2.9.4. 


Table B-10. Developer Workbench Shortcuts — Run Control (Sheet 1 of 2) 


Button 

Keyboard 

Menu 

Action 

Reference 


H 


F5 

Debug, Run Control, 
Go 

Start simulation. 

Section 2.11 .8.10, 
Section 2.11 .9.2. 


H 


SHIFT+F5 

Debug, Run Control, 
Stop 

Stop simulation. 

Section 2.11 .8.10, 
Section 2.11 .9.2. 


W 


F10 

Debug, Run Control, 
Step Over 

Step over. 

Section 2.11 .8.3. 


w 


F11 

Debug, Run Control, 
Step Into 

Step into (Compiler 
thread only). 

Section 2.11 .8.4. 




SHIFT+F11 

Debug, Run Control, 
Step Out 

Step out (Compiler 
thread only). 

Section 2.11 .8.5. 
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Table B-10. Developer Workbench Shortcuts — Run Control (Sheet 2 of 2) 


Button 

Keyboard 

Menu 

Action 

Reference 


T} 


CTRL+F10 

Debug, Run Control, 
Run To Cursor 

Run to cursor. 

Section 2.11 .7.5. 


3 


SHIFT+F10 

Debug, Run Control, 
Step Microengines 

Step Microengines. 

Section 2.11 .8.2. 


E 

1 

CTRL+SHIFT+F12 

Debug, Run Control, 
Reset 

Reset. 

Section 2.11 .8.11 , 
Section 2.11 .9.4. 


Table B-11. Developer Workbench Shortcuts — View 


Button 

Keyboard 

Menu 

Action 

Reference 


CTRL+F6 

Window, <filename> 

Make next window 
active. 

Section 2.3.2. 


J» 


ALT+V+O 

View, Output Window 

Toggle visibility of Output 
window. 

Section 2.3.2. 




ALT+V+D+C 

View, Debug Window, 
Command Line 

Toggle visibility of 
Command Line window. 

Section 2.11 .5. 




ALT+V+D+D 

View, Debug Window, 
Data Watch 

Toggle visibility of Data 
Watch window. 

Section 2.11 .12. 




ALT+V+D+M 

View, Debug Window, 
Memory Watch 

Toggle visibility of 
Memory Watch window. 

Section 2.11 .13 




ALT+V+D+H 

View, Debug Window, 
History 

Toggle visibility of History 
window. 

Section 2.11 .16. 


M 


ALT+V+D+T 

View, Debug Window, 
Thread Status 

Toggle visibility of Thread 
Status window. 

Section 2.11 .18. 


Q Q 
Q Q 


ALT+V+D+Q 

View, Debug Window, 
Queue Status 

Toggle visibility of Queue 
Status window. 

Section 2.11 .17. 


© 


ALT+V+D+I 

View, Debug Window, 
IX Bus Status 

Toggle visibility of IX Bus 
Status window. 

Section 2.11 .23.4. 




ALT+V+D+R 

View, Debug Window, 
Run Control 

Toggle visibility of Run 
Control window. 

Section 2.11 .8. 
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